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1.1  MODEL  4  THEORY  OF  OPERATION 


1.1.1  introduction 

The  TRS-80  Model  4  Microcomputer  is  a  self-contained 
desktop  microcomputer  designed  not  only  to  be  completely 
software  compatible  with  the  TRS-80  Model  III,  but  to  pro- 
vide many  enhancements  and  features.  System  distinctions 
which  enable  the  Model  4  to  be  Model  III  compatible 
include:  a  Z80  CPU  capable  of  running  at  a  4  MHz  clock 
rate,  BASIC  operating  system  in  ROM  (14K),  memory- 
mapped  keyboard,  64-character  by  16-line  memory-mapped 
video  display,  up  to  128K  Random  Access  Memory,  cassette 
circuitry  able  to  operate  at  500  or  1500  baud,  and  the 
ability  to  accept  a  variety  of  options  These  options  include: 
one  to  four  5-1/4  inch  double  density  floppy  disk  drives,  one 
to  four  five  megabyte  hard  disk  drives,  an  RS-232  Serial 
Communications  Interface,  and  a  640  by  240  pixel  high 
resolution  graphics  board. 

1.1.2  CPU  and  Timing 

The  central  processing  unit  of  the  Model  4  microcomputer 
is  the  Z80-A  microprocessor  -  capable  of  running  at  either 
a  two  {2  02752)  or  four  (4  05504)  MHz  clock  rate.  The  main 
CPU  timing  comes  from  the  20  MHz  (20  2752  MHz)  crystal- 
controlled  oscillator,  Y1  and  Q1,  There  is  an  additional 
12  MHz  (12  672  MHz)  oscillator,  Y2  and  Q2,  which  is 
necessary  for  the  80  by  24  mode  of  video  operation.,  The 
oscillator  outputs  are  sent  to  two  Programmable  Array 
Logic  (PAL)  circuits,  U3  and  U4,  for  frequency  division 
and  routing  of  appropriate  timing  signals 

PAL  U3  divides  the  20  MHz  signal  by  five  for  4  MHz  CPU 
operation,  by  ten  for  a  2  MHz  rate,  and  slows  the  4  MHz 
clock  tor  the  M1  Cycle  (See  Figure  1-3)  U3  also  divides  the 
master  clock  by  four  to  obtain  a  5  MHz  clock  to  be  sent  to 
the  RS-232  option  connector  as  a  reference  for  the  baud 
rate  generator,  PAL  U4  selects  an  appropriate  10  MHz  or  12 
MHz  clock  for  the  video  shift  clock,  and  using  divider  U5 
provides  additional  timing  signals  to  the  video  display  cir- 
cuitry {See  Fig.  1-4)., 

Hex  latch  U18  is  clocked  from  the  20  MHz  clock,  and  is 
used   to   provide   MUX   and   CAS  timing  for  the  dynamic 


PortAddr,  (Hex) 


Read  Function 


memory  circuits.  Also,  with  additional  gates  from  U16, 
U19,  U20,  U31,  and  U32,  this  chip  provides  the  wait  cir- 
cuitry necessary  to  prevent  the  CPU  from  accessing  video 
RAM  during  the  active  portion  of  the  display.  This  Is  done 
by  latching  the  data  for  the  video  RAM  and  simultaneously 
forcing  the  Z80  CPU  into  a  "WAIT"  state  and  is  necessary 
to  eliminate  undesirable  "hashing"  of  the  video  display 
(See  Fig.  1-4). 

1.1.3  Buffering 

Low  level  signals  from  and  to  the  CPU  need  to  be  buffered, 
or  current  amplified  in  order  to  drive  many  other  circuits 
The  16  address  lines  are  buffered  by  U55  and  U56,  which  are 
unidirectional  buffers  that  are  permanently  enabled.  The 
eight  data  lines  are  buffered  by  U71  Since  data  must  flow 
both  to  and  from  the  CPU,  U71  is  a  bi-directtonal  buffer 
which  can  go  Into  a  three-state  condition  when  not  in  use. 
Both  direction  and  enable  controls  come  from  the  address 
decoding  section. 

The  clock  signal  to  the  CPU  (from  PAL  U3)  is  buffered  by 
active  pullup  circuit  Q3  RESET  and  WAIT  inputs  to  the 
CPU  are  buffered  by  U17  and  U46„  Control  outputs  from 
the  Z80  (MT,  RD#,  WR\  MREQ*,  and  IORQ*)  are  sent 
to  PAL  U58,  which  combines  these  into  other  appropriate 
control  signals  consistent  with  Model  4's  architecture  Other 
than  MREQ*,  which  is  buffered  by  part  of  U38,  the  raw 
control  signals  go  to  no  other  components,  and  hence  require 
no  additional  buffering, 

1:1.4  Address  Decoding 

The  address  decoding  section  is  divided  into  two  sub- 
sections: Port  address  decoding  and  Memory  address 
decoding., 

in  port  address  decoding,  low  order  address  lines  (some 
combined  through  a  portion  of  U32)  are  sent  to  the  address 
and  enable  inputs  of  U48,  U49,  and  U50,  U48  is  also  enabled 
by  the  IN*  signal,  which  means  that  is  decodes  port  input 
signals,  while  U49  decodes  port  output  signals,  A  table  of 
the  resulting  port  map  is  shown  below: 

Write  Function 


FC-  FF 

F8-  FB 
(1)    F4-  F7 
(1)    F3 
(1)    F2 
(1)    F1 


Cassette  In,  Mode  Read 

Read  Printer  Status 
-  reserved  - 
FDC  Data  Reg, 
FDC  Sector  Reg., 
FDC  Track  Reg 


Cassette  Out,  resets 
cassette  data  latch 
Output  to  Printer 
Drive  Select  latch 
FDC  Data  Reg. 
FDC  Sector  Reg 
FDC  Track  Reg. 
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(1)    F0 

EC 

-EF 

(2)    EB 

(2)    EA 

(2)    E9 

{2)    E8 

E4  ■ 

■E7 

EO- 

■E3 

(3}    CF 

(3)    CE 

(3)    CD 

(3)    CC 

(3)    CB 

{3)    CA 

{3}    C9 

(3)    CB 

(3)    C7 

{3}    C6 

(3}   C5 

(3)    C4 

(3)    C2- 

C3 

(3)    CI 

{3}    CO 

94- 

9F 

(4}   90- 

93 

(5)    8C- 

8F 

8B 

8A 

89 

88 

84- 

87 

(5)    83 

(5)    82 

(5)    81 

(5)   80 

FDC  Status  Reg. 

Resets  RTC  Int. 
Rcvr  Holding  Reg, 
UART  Status  Reg, 

-  reserved  ■• 
Modem  Status 

Read  NM!  Status 
Read  INT  Status 
HD  Status 
HDSize/Drv/Hd 
HD  Cylinder  high 
HD  Cylinder  low 
HD  Sector  Number 
HD  Sector  Count 
HD  Error  Reg, 
HD  Data  Reg. 
HDCTC  channel  3 
HDCTC  channel  2 
HDCTC  channel  1 
HDCTC  channel  0 
HD  Device  ID  Reg 
HD  Control  Reg 
HD  Wr  Prot.  Reg 

-  reserved  - 

-  reserved  - 
Graphics  Set r  2 
CRTC  Data  Reg 
CRTC  Control  Reg. 
CRTC  Data  Reg, 
CRTC  Control  Reg 

-  reserved  - 

-  reserved  - 

-  reserved  - 
Graphics  Ram  Rd 

-  reserved  - 


FDC  Command  Reg, 
Mode  Output  latch 
Xmit  Holding  Reg 
UART/Modern  control 
Baud  Rate  Register 
Master  Reset/Enable 
UART  control  reg, 
Write  NM!  Mask  reg. 
Write  INT  Mask  reg. 
HD  Command 
HDSize/Drv/Hd 
HD  Cylinder  high 
HD  Cylinder  low 
HD  Sector  Number 
HD  Sector  Count 
HD  Write  Precomp 
HD  Data  Reg. 
HDCTC  channel  3 
HD  CTC  channel  2 
HDCTC  channel  1 
HDCTC  channel  0 

-  reserved  - 

HD  Control  Reg, 

-  reserved  - 
■  reserved  - 
Sound  Option 
Graphics  Sel,  2 
CRTC  Data  Reg, 
CRTC  Control  Reg 
CRTC  Data  Reg, 
CRTC  Control  Reg, 
Options  Register 
GraX  Reg,  Write 
Gra,  Y  Reg.  Write 
Graphics  Ram  Wr, 
Gra  Options  Reg  Wr 


Notes:     (1)  Valid  only  if  FDC  option  is  installed 

{2}  Valid  only  if  RS-232  option  is  installed 

(3)  Valid  only  if  Hard  Disk  option  is  installed 

(4)  Valid  only  if  sound  option  is  installed 

(5)  Valid  only  if  High  Resolution  Graphics  option  is  installed 
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Following  is  a  Bit  Map  of  the  appropriate  ports  in  the  Mode!  4,  Note  that  this  is  an  "internal"  bit  map  only,.  For  bit  maps  of  the 
optional  devices,  refer  to  the  appropriate  section  of  the  desired  manual. 


Port 

D7 

FC-FF 

Cass 

(READ) 

data 

500  bd 

FC-FF 

(WRITE) 

X 

F8-  FB 

Prntr 

(READ) 

BUSY 

HJ-  FB 

Prntr 

(WRITE) 

D7 

Model  4  Port  Bit  Map 
D4  D3 


(MIRROR    of   PORT     EC) 


(Note,  also  resets  cassette  data  latch} 


Prntr 
Paper 


rrntr 
D6 


Prntr 
Select 


Prntr 
Fault 


mi  u 
D5 


n  nit 
D4 


D3  D2  D1 

(Any  Read  causes  reset  of  Real  Time  Clock  Interrupt) 


EC-EF 
(WRITE) 


E0-  E3 

(READ) 


E0-E3 
(WRITE) 


90-93 

(WRITE) 


84  -87 

(WRITE) 


CPU 

X 

Enable 

Enable 

Fast 

X 

EX  I/O 

Altset 

Receive 

Receive 

Xmit 

10  Bus 

Error 

Data 

Empty 

Int 

Enable 

Enable 

Enable 

Enable 

Rec  Err 

Rec  Data 

Xmit  Emp 

10  Int 

Mode 
Select 


Enable 
RTInt 


Page 


Fix  Upr 

Memory 


Memory 
Bit  1 


Memory 
BitO 


Invert 
Video 


Cass 

Mot  On 


C  Fall 
Int 


Enable 
CF  Int 


Select 
Bit  1 


DO 
Cassette 


data 
1 500  bd 


cassette 
data  out 


C  Rise 
Int 


Enable 
CR  Int 


Sound 
Bit 


Select 
BitO 


Memory  mapping  is  accomplished  by  PAL  U59  in  the  Basic  16K  or  64K  computer  In  a  128K  system,  PAL  U72,  along  with  the 
select  and  memory  bits  of  the  options  register,  also  enter  into  the  memory  mapping  function. 

Four  memory  maps  are  listed  below.  Memory  Map  I  is  compatible  with  the  Model  III .  Note  that  there  are  two  32K  banks  in  the 
54K  system,  which  can  be  interchanged  with  either  position  of  the  upper  two  banks  of  a  128K  system^  The  128K  system  has 
four  moveable  32K  banks,.  Also  note,  in  the  Model  111  mode,  that  decoding  for  the  printer  status  read  (37E8and  37E9  hexadeci- 
mal) is  accomplished  by  U93  and  leftover  gates  from  U40,  U46,  U51 ,  U54,  U60,  and  U62 

Memory  Map  I  —  Model  Ml  Mode 


0000-  1FFF 
2000-2FFF 
3000-37FF 
37E8-37E9 
3800-3BFF 
3CO0-3FFF 
4000-7FFF 
4000-  FFFF 


ROM  A  (8K) 

ROW!  B  (4K) 

ROM  C  (2K)  -  Less  37E8  -  37E9 

Printer  Status  Port 

Keyboard 

Video  RAM  (Page  bit  selects  1 K  of  2K) 

RAM  (16K  system) 

RAM  (64K  system) 
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Memory  Map  II 


0000-37FF 
3800-3BFF 
3C0O-3FFF 
4000-7FFF 

8000 -FFFF 


0000-7FFFF 

8000-  F3FF 
F400-  F7FF 
F800-  FFFF 


RAM  (14K) 
Keyboard 
Video  RAM 
RAM  (16K) 

RAM  (32K) 

Memory  Map  Ml 

RAM  (32K) 

RAM  (29K) 
Keyboard 
Video  RAM 


End  of  one32K  Bank 
Second  32K  Bank 


End  of  One  32 K  Bank 
Second  32K  Bank 


1.1.5  ROM 


0000-  7FFF 
8000™  FFFF 


Memory  Map  IV 


RAM  (32K) 
RAM  (32K) 


One32K  Bank 
Second  32K  Bank 


(See  Figure  1-2  for  128K  Maps) 


The  Model  4  Microcomputer  contains  14K  of  Read  Only 
Memory  (ROM),  which  is  divided  into  an  8K  ROM  (U68),  a 
4K  ROM  (U69),  and  a  2K  ROM  (U70).  ROMs  used  have 
three-state  outputs  which  are  disabled  if  the  ROMs  are 
deselected.  As  a  result,  ROM  data  outputs  are  connected 
directly  to  the  CPU  data  bus  and  do  not  use  data  buffer 
U71f  which  is  disabled  during  a  ROM  access, 

ROMs  are  Model  III  compatible  and  contain  a  BASIC  opera- 
ting system,  as  well  as  a  floppy  disk  boot  routine.  The  enable 
inputs  to  the  ROMs  are  provided  by  the  address  decoding 
section,  and  are  present  only  in  the  Model  III  mode  of 
operation. 

1.1.6  RAM 

Three  configurations  of  Random  Access  Memory  are  avail- 
able on  the  Model  4:  16K,  64K,  and  128K  The  16K  option 
uses  4116  type,  16K  by  1  dynamic  RAMs,  which  require 
three  supply  voltages  (+12  volts,  +5  volts,  and  ~5  volts). 
The  64 K  and  128K  options  use  6665  type,  64K  by  1  dyna- 
mic RAMs,  which  require  only  a  single  supply  voltage  (+5 
volts)  The  proper  voltage  for  each  option  is  provided  by 
jumpers. 

Dynamic  RAMs  require  multiplexed  incoming  address  lines. 
This  is  accomplished  by  JCs  U63  and  U76,  Output  data 
from  RAMs  is  buffered  by  U64.  With  the  128K  option,  there 
are  two  rows  of  the  64K  by  1  RAM  ICs  The  proper  row  is 
selected  by  the  CAS*  signal  from  PAL  U72, 


1.1.7  Keyboard 

The  Model  4  Keyboard  is  a  70-key  sculptured  keyboard, 
scanned  by  the  microprocessor,  Each  key  is  identified  by 
its  column  and  row  position  Columns  are  defined  by  address 
lines  A0  -  A7,  which  are  buffered  by  open-collector  drivers 
U29  and  U30,  Data  lines  DO  -  D7  define  the  rows  and  are 
buffered  by  CMOS  buffers  U44  and  U45.  Row  inputs  to  the 
buffers  are  pulled  up  by  resistor  pack  RP  1,  unless  a  key 
in  the  current  column  being  scanned  is  depressed,,  Then, 
the  row  for  that  key  goes  low 

1.1.8  Video 

The  heart  of  the  video  display  circuitry  in  the  Model  4  is 
the  68045  Cathode  Ray  Tube  Controller,,  The  CRTC  allows 
two  screen  formats:  64  by  16  and  80  by  24.  Since  the  80 
by  24  screen  requires  1,920  screen  memory  locations,  a 
2K  by  8  static  RAM  is  used  for  the  Video  RAM,  The  64 
by  16  mode  has  a  two-page  screen  display  and  a  bit  in  the 
options  register  for  determining  which  page  is  active  for 
the  CPU,,  Offset  the  start  address  of  the  CRTC  to  gain 
access  to  the  second  page  in  the  64  by  1 6  mode. 

Addresses  to  the  video  RAM  are  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating 
the  data  These  two  sets  of  addresses  are  multiplexed  by 
U33,  U34,  and  U35,  Data  between  the  CPU  and  Video 
RAM  is  latched  by  U6  for  a  write,  and  buffered  by  U7  for 
a  read  operation, 
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FIGURE  1-2.  RAM  MEMORY 
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During  screen  refresh,  the  data  outputs  of  the  Video  RAM 
(ASCI!  character  codes)  are  latched  by  U8  and  become  the 
addresses  for  the  character  generator  ROM  (U23),  in  cases 
of  iow  resolution  graphics,  a  dual  1  of  4  data  selector  (U9) 
is  the  cell   generator,  with  additional  buffering  from   U10 

The  shift  register  U11  inputs  are  the  latched  data  outputs 
of  the  character  or  cell  generator.  The  shift  clock  input 
comes  from  the  PAL  U4,  and  is  10,1376  MHz  for  the  64 
by  16  mode  and  12,672  MHz  for  80  by  24  operation,  The 
serial  output  from  the  shift  register  later  becomes  actual 
video  dot  information, 

Special  timing  in  the  video  circuit  is  handled  by  hex  latch 
U2.  This  includes  blanking  {originating  from  CRTC)  and 
shift  register  loading  (originating  from  U4)  Additional 
video  control  and  timing  functions,  such  as  sync  buffering, 
inversion  selection,  dot  clock  chopping,  and  graphics  disable 
of  normal  video,  are  handled  by  miscellaneous  gates  in  U12, 
U13,  U14,  U22,  U24,and  U26„ 

1.1.9  Real  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4  provides  a  30 
Hz  {in  the  2  MHz  CPU  Mode)  or  60  Hz  {in  the  4  MHz  CPU 
Mode)  interrupt  to  the  CPU .  By  counting  the  number  of 
interrupts  that  have  occured,  the  CPU  can  keep  track  of  the 
time.  The  60  Hz  vertical  sync  signal  from  the  video  circuitry 
is  divided  by  two  (2  MHz  Mode)  by  U53,  and  the  30  Hz  at 
pin  1  of  U51  is  used  to  generate  the  interrupts  In  the  4 
MHz  mode,  signal  FAST  places  a  logic  low  at  pin  1  of  U51, 
causing  signal  VSYNC  to  trigger  the  interrupts  at  the  60  Hz 
rate.  Note  that  any  time  interrupts  are  disabled,  the  accuracy 
of  the  clock  suffers. 

1.1.10  Cassette  Circuitry 

The  cassette  write  circuitry  latches  the  two  LSBs  (DO  and 
D1)  for  any  output  to  port  FF  {hex),  The  outputs  of  these 
latches  (U27)  are  then  resistor  summed  to  provide  three 
discrete  voltage  levels  (500  Baud  only).,  The  firmware  toggles 
the  bits  to  provide  an  output  signal  of  the  desired  frequency 
at  the  summing  node, 

There  are  two  types  of  cassette  Read  circuits  —  500  baud  and 
1500  baud  The  500  baud  circuit  is  compatible  with  both 
Model  1  and  lit.  The  input  signal  is  amplified  and  filtered 
by  Op  amps  {U43  and  U28  Part  of  U15  then  forms  a 
Zero  Crossing  Detector,  the  output  of  which  sets  the  latch 
U40  A  read  of  Port  FF  enables  buffer  U41,  which  allows 
the  CPU  to  determine  whether  the  latch  has  been  set,  and 
simultaneously  resets  the  latch  The  firmware  determines 
by  the  timing  between  settings  of  the  latch  whether  a  logic 
"one"  or  "zero"  was  read  in  from  the  tape, 


The  1500  baud  cassette  read  circuit  is  compatible  with  the 
Model  III  cassette  system,,  The  incoming  signal  is  compared 
to  a  threshold  by  part  of  U15,  U15's  output  will  then  be 
either  high  or  iow  and  clock  about  one-half  of  U39,  depend- 
ing on  whether  it  is  a  rising  edge  or  a  falling  edge.  If 
interrupts  are  enabled,  the  setting  of  either  latch  will  gene- 
rate an  interrupt.  As  in  the  500  baud  circuit,  the  firmware 
decodes  the  interrupts  into  the  appropriate  data. 

For  any  cassette  read  or  write  operation,  the  cassette  relay 
must  be  closed  in  order  to  start  the  motor  of  the  cassette 
deck.  A  write  to  port  EC  hex  with  bit  one  set  will  set  latch 
U42,  which  turns  on  transistor  Q4  and  energizes  the  relay 
K1,  A  subsequent  write  to  this  port  with  bit  one  clear 
will  clear  the  latch  and  de-energize  the  relay , 

1.1.11  Printer  Circuitry 

The  printer  status  lines  are  read  by  the  CPU  by  enabling 
buffer  U67  This  buffer  will  be  enabled  for  any  input  from 
port  F8  or  F9,  or  any  memory  read  from  location  37E8 
or  37E9  when  in  the  Model  III  mode.  For  a  listing  of  bit 
status,  refer  to  the  bit  map, 

After  the  printer  driver  software  determines  that  the  printer 
is  ready  to  receive  another  character  (by  reading  the  status), 
the  character  to  be  printed  is  output  to  port  F8,  This  latches 
the  character  into  U66,  and  simultaneouly  fires  the  one-shot 
U65  to  provide  the  appropriate  strobe  to  the  printer 

1.1.12  I/O  Connectors 

Two  20-pin  single  inline  connectors,  J7  and  J8,  are  provided 
for  the  connection  of  a  Floppy  Disk  Controller  and  an 
RS-232  Communications  Interface,  respectively.  All  eight 
data  lines  and  the  two  least  significant  address  lines  are 
routed  to  these  connectors.,  In  addition,  connections  are 
provided  for  device  or  board  selection,  interrupt  enable, 
interrupt  status  read,  interrupt  acknowledge,  RESET,  and 
the  CPU  WAIT  signal. 

The  graphics  connector,  J10,  contains  all  of  the  above  inter- 
face signals,  plus  CRTCLK,  the  dotctock  signal,  a  graphics 
enable  input,  and  other  timing  clocks  which  synchronize 
the  graphics  board  with  the  CRTC. 

The  I/O  bus  connector,  J2,  contains  connections  for  all 
eight  data  lines  {buffered  by  U74),  the  low  order  address 
lines  {buffered  by  U73),  and  the  control  lines  {buffered  by 
U75)  IN*,  OUT*,  RESET*,  M1\and  lOROV,  In  addition, 
the  I/O  bus  connector  has  inputs  to  allow  the  device(s), 
connected   to   generate   CPU   WAIT  states  and   interrupts. 
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The  sound  connector,  J11,  contains  only  four  connections: 
sound  enable  (any  output  to  port  90  hex),  data  bit  DO, 
Vcc,  and  ground,. 

1.1.13  Sound  Option 

The  Model  4  sound  option,  available  as  standard  equipment 
on  the  disk  drive  versions,  is  a  software  intensive  device  Data 


is  sent  out  to  port  90H,  alternately  setting  and  clearing 
data  bit  DO  The  state  of  this  bit  is  latched  by  sound  board 
U1  and  amplified  by  sound  board  Ol,  which  drives  a  pie- 
zoelectric sound  transducer.  The  speed  of  the  software 
loop  determines  the  frequency,  and  thus,  the  pitch  of  the 
resulting  tone 
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1.2  MODEL  4  I/O  BUS 

The  Model  4  Bus  is  designed  to  allow  easy  and  convenient 
interfacing  of  I/O  devices  to  the  Model  4.  The  I/O  Bus 
supports  all  the  signals  necessary  to  implement  a  device  com- 
patible with  the  Z-8Qs  I/O  structure   That  is: 

Addresses: 

AG  to  A7  allow  selection  of  up  to  256*  input  and  256 
output  devices  if  external  i/O  is  enabled., 

t Ports  8GH  to  0FFH  are  reserved  for  System  use. 


DB0  to  D87  allow  transfer  of  8  bit  data  onto  the  pro- 
cessor data  bus  if  external  I/O  is  enabled 

Control  Lines: 

a  in*  -  Z-80  signal  specifying  that  an  input  is  in  pro- 
gress  Gated  with  iORu.. 

b,  OUT*  -  Z-80  signal  specifying  that  an  output  is  in 
progress  Gated  with  IORO, 

c„      RESET*  —  system  reset  signal 

d.  IOBUSINT*  -  input  to  the  CPU  signaling  an  inter- 
rupt from  an  I/O  Bus  device  if  I/O  Bus  interrupts 
are  enabled 

e.  IOSUSWAIT*  ~  input  to  the  CPU  wait  line  allow- 
ing I/O  Bus  device  to  force  wait  states  on  the  Z-80 
if  external  I/O  is  enabled 

f.  EXTIOSEL"  -  input  to  CPU  which  switches  the 
I/O  Bus  data  bus  transceiver  and  allows  an  INPUT 
instruction  to  read  I/O  Bus  data,. 

g       M1  *  -  and  IORQ*  -  standard  Z-80  signals 

The  address  line,  data  line,  and  control  lines  a  to  c  and  e  to  g 
are  enabled  only  when  the  ENEXIO  bit  in  EC  is  set  to  a  one 

To  enable  I/O  interrupts,  the  EN  IOBUSINT  bit  in  the  CPU 
IOPORT  EG  (output  port)  must  be  a  one,  However,  even  if 
it  is  disabled  from  generating  interrupts,  the  status  of  the 
IOBUSINT*  line  can  still  read  on  the  appropriate  bit  of  CPU 
IOPORT  EG  (input  port) 

See  Model  4  Port  Bit  assignment  for  port  OFF,  0  EC,  and 
0E0on  pages  Hand  15 

The  Mode!  4  CPU  board  is  fully  protected  from  "foreign 
I/O  devices"  in  that  all  the  I/O  Bus  signals  are  buffered  and 
can  be  disabled  under  software  control  To  attach  and  use  an 
I/O  device  on  the  I/O  Bus,  certain  requirements  {both  hard- 
ware and  software)  must  be  met. 


For  input  port  device  use.  you  must  enable  external  I/O  de- 
vices by  writing  to  port  0ECH  with  bit  4  on  in  the  user  soft- 
ware. This  will  enable  the  data  bus  address  lines  and  control 
signals  to  the  I/O  Bus  edge  connector  When  the  input  de- 
vice is  selected,  the  hardware  will  acknowledge  by  asserting 
EXTIOSEL*  low  This  switches  the  data  bus  transceiver  and 
allows  the  CPU  to  read  the  contents  of  the  I/O  Bus  data 
lines  See  Figure  1  6  for  the  timing  EXTIOSEL*  can  be  gen- 
erated by  NANDing  IN  and  the  I/O  port  address 

Output  port  device  use  is  the  same  as  the  input  port  device  in 
use,  in  that  the  external  I/O  devices  must  be  enabled  by  writ- 
ing to  port  0ECH  with  bit  4  on  in  the  user  software  -  in  the 
same  fashion. 

For  either  input  or  output  devices,  the  IOBUSWAIT*  control 
line  can  be  used  in  the  normal  way  for  synchronizing  slow 

used  in  the  Model  4,  the  wait  line  should  be  used  with  cau- 
tion. Holding  the  CPU  in  a  wait  state  for  2  msec  or  more  may 
cause  loss  of  memory  contents  since  refresh  is  inhibited  during 
this  time,  It  is  recommended  that  the  IOBUSWAIT*  line  be 
held  active  no  more  than  500  jisec  with  a  25%  duty  cycle 

The  Model  4  will  support  Z-80  mode  1  interrupts-  A  RAM 
jump  table  is  supported  by  the  LEVEL  II  BASIC  ROMs  and 
the  user  must  supply  the  address  of  his  interrupt  service 
routine  by  writing  this  address  to  locations  403E  and  403F 
When  an  interrupt  occurs,  the  program  will  be  vectored  to 
the  user  supplied  address  if  I/O  Bus  interrupts  have  been 
enabled  To  enable  I/O  Bus  interrupts,  the  user  must  set  bit 
3  of  PortGEGH. 
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1,3  MODEL  4  PORT  BITS 


Name:  WRNMJMASKREG " 

Port  Address:      0E4H 
Access:  WRITE  ONLY 

Bit  7  =  ENiNTRQ;    0  disables  Disk  INTRO,  from  generating 
an  NMI 
1  enables  above 

Bit  6=  ENDRQ;     0  disables  Disk   DRQ  from  generating  an 
NMI 
1  enables  above 

Name:  RDNMISTATUS* 

Port  Address:      0E4H 
Access:  READONLY 

Bit  7  =  Status  of  Disk  INTRO;   1  =  False.  0  =  True 

Bit  6  =  Status  of  Disk  DRQ;   1  =  False.  0  =  True 

Bit  5  =  Reset*  Status;    1  =  False,  0  =  True 

Name:  MOD  OUT 

Port  Address:      0ECH 
Access:  WRITE  ONLY 

Bit  7  =  Undefined 

Bit  6=  Undefined 

Bit  5  =  DISWAIT;  0  disables  video  waits.  1  enables 

Bit  4  =  ENEXTIO;  0  disables  external  IO  Bus,  1  enables 

Sit  3  =  ENALTSET;  0  disables  alternate  character  set. 
1  enables  alternate  video  character  set 

Bit  2  =  MODSEL;  0  enables  64  character  mode, 
1  enables  32  character  mode 

Bit  1  =  CASMOTORON;  0  turns  cassette  motor  off. 
1  turns  cassette  motor  on 

Bit  0  =  Undefined 


Name:  RDSNTSTATUS' 

Port  Address:      0E0H 
Access:  READONLY 

NOTE:    A  0  indicates  the  device  is  interrupting 

Bit  7  =  Undefined 

Bit  6=  RS-232  ERROR  INT 

Bit  5=  RS-232  RCV  INT 

Bit  4  =  RS-232  XM1T  INT 

Bit  3=  IOBUS  INT 

Bit  2=  RTC  INT 

Bit  1  =  CASSETTE  (1500  Baud)      INT  F 

Bit  0  =  CASSETTE  (1500  Baud}      INT  R 

Name:  CASOUT" 

Port  Address:      0FFH 
Access:  WRITE  ONLY 

Bit  7  =  Undefined 

Bit  6  =  Undefined 

Bit  5  =  Undefined 

Bit  4  =  Undefined 

Bit  3=  Undfined 

Bit  2  =  Undefined 

Bit  1  =  Cassette  output  level 

Bit  0  =  Cassette  output  level 
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Name:  WRJNTMASK  REG  * 

Port  Address:      0E0H 
Access:  WRITE  ONLY 

Bit  7  =  Undefined 

Bit  6  =  ENERRORINT;    1  enables  RS-232  interrupts  on  par 
it y  error,  framing  error,  or  data  overrun  error 
0  disable  above 

Bit  5  =  ENRCVINT;     1  enables  RS-232  receive  data  register 
full  interrupts. 
0  disables  above 

Bit  4  =  ENXMITINT;    1  enables  RS-232  transmitter  holding 
register  empty  interrupts. 
0  disables  above 

Bit  3  =  ENIOBUSINT;  1  enables  I/O  Bus  interrupts, 
0  disables  the  above 

Bit  2  =  ENRTC;   1  enables  real  time  clock  interrupt, 
0  disables  above. 


Name:  DRVSEL' 

Port  Address:      0F4H 

Access:  WRITE  ONLY 

Bit  7  =  FM  7MFM;  0  selects  single  density, 
1  selects  double  density 

Bit  6  =  WSGEN;  0  =  no  wait  states  generated, 
1  =  wait  states  generated 

Bit  5  =  PRECOMP;  0  =  no  write  precompensation. 
1  =  write  precompensation  enabled 

Bit  4  =  SDSEL;  Q  selects  side  0  of  diskette. 
1  selects  side  1  of  diskette 

Bit  3  =  Drive  select  4 

Bit  2  =  Drive  select  3 

Bit  1  =  Drive  select  2 

Bit  0  =  Drive  select  1 


Bit  1  =  ENCASINTF;    1  enables  1500  Baud  falling  edge  inter- 
rupt. 
0  disables  above 

Bit  0  -  ENCASINTR;    1  enables  1500  Baud  rising  edge  inter- 
rupt, 
0  disables  above 


Name:  CAS  IN* 

Port  Address:      0FFH 
Access:  READ  ONLY 

Bit  7  =  500  Baud  Cassette  bit 

Bit  6  =  Undefined 

Bit  5  =  DISWAIT   (See  Port  0ECH  definition} 

Bit  4  =  ENEXTIO    (See  Port  0ECH  definition} 

Bit  3  =  ENALTSET  (See  Port  0ECH  definition) 

Bit  2  *  MODSEL    (See  Port  0ECH  definition} 

Bit  1  =  CASMOTORON   (See  Port  0ECH  definition) 

Bit  0  =  1 500  Baud  Cassette  bit 

NOTE:     Reading  Port  0FFH  clears  the  1500  Baud  Cassette 
interrupts 
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SECTION  II 


4  GATE  ARRAY  THEORY  OF  OPERATION 
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2.1    MODEL 
OPERATION 


4    GATE    ARRAY    THEORY    OF 


2.1.1  Introduction 

The  following  discusses  each  element  of  the  main  board  of 
the  Model  4  Gate  Array  block  diagram  (see  Figure  2-1).  In 
each  case  the  intent  is  understanding  the  operation  on  a 
practical  level  sufficient  to  aid  in  isolating  a  problem  to  the 
failing  component, 

2.1.2  Reset  Circuit 

Figure  2-2  shows  the  Reset  circuit  for  generation  of  reset  on 
power  up  and  when  the  reset  switch  is  pushed  on  the  key- 
board The  time  constant  determined  by  R8  and  C25,  is 
used  to  allow  the  system  to  stabilize  before  triggering  a  one 
shot  (U63)  with  an  approximate  pulse  width  of  70  microsecs 
When  the  reset  switch  is  pushed,  the  input  pin  is  brought  to 
ground  and  fires  the  one  shot  when  the  switch  is  released 

A  second  point  to  be  noted  is  the  signal  POWRS*  which  is 
used  to  reset  the  drive  select  latch  in  the  FDC  circuit 

2.1.3  CPU 

The  central  processing  unit  of  the  Model  4  microcomputer  is 
a  Z80A  microprocessor,  and  will  run  in  either  2  or  4  MHz 
mode.  All  of  the  output  lines  of  the  280A  are  buffered  The 
address  lines  are  buffered  by  two  74LS244s  (U2  and  U3 
with  the  enable  tied  to  ground),  the  control  lines  by  a  74F04 
(U27),  and  the  data  lines  by  a  74LS245  (U28  with  the  ena- 
ble tied  to  BUSEN*  and  the  direction  control  tied  to 
BUSDIR*) 

2.1.4  System  Timing  and  Control  Registers 
Control  Registers 

The  first  of  these  registers  is  the  WRINTMASKREG  (U34) 
This  is  only  part  of  the  register  as  this  function  is  shared 
with  the  Gate  Array  4  5.  The  main  register  contains  RTC 
ENCASINTFALL  AND  ENCASINTRISE  The  Gate  Array  has 
the  interrupts  for  the  RS232C  Interface  and  the  I/O  bus  in- 
terrupts and  a  duplicate  of  the  RTC 

The  second  is  the  OPREG  <U33)  which  contains  the  added 
options  of  the  Mode!  4  for  video  and  Memory  mapping 

The  last  of  the  registers  is  MODOUT  (U53)  and  is  also  read- 
able through  the  CASSIN  (U52)  buffer  It  contains  the  Cas- 
sette motion  controls,  and  the  FAST  control  for  Model  4 


CPU  Clock  and  RS232  Clock 

Most  of  the  timing  generation  for  the  board  is  shown  in  Fig- 
ure 2-5,  The  Gate  Array  4  11  is  the  basis  for  this  timing  as 
it  produces  the  20,2752  MHz  clock  and  then  divides  this 
down  to  produce  most  of  the  other  clocking  functions  used 
on  the  board 

The  first  clock  that  is  produced  is  PCLK  {pin  23)  which 
drives  the  CPU,  It  is  a  divide  by  ten  of  the  20  2752  MHz  in 
the  2  MHz  mode  and  a  divide  by  5  in  the  4  MHz  mode  The 
transition  from  one  mode  to  the  other  is  without  glitches  and 
both  modes  are  50  percent  duty  cycles 

Note  that  the  signal  that  controls  this  mode  also  controls  the 
Real  Time  Clock  circuit  described  later 

As  a  simple  divide  by  four  of  the  fundamentai  20  2752  MHz, 
the  RS232CLK  on  pin  22  of  U9  provides  the  basic  clock  to 
the  RS232C  circuit 

Video  and  Graphics  Clocking  and  Timing 

The  timing  for  both  of  these  functions  may  be  viewed  as  one 
since  they  must  operate  synchronously  and  the  same  timing 
must  be  generated  for  both  The  additional  signals  sent  to 
the  Graphics  Board  allow  it  to  maintain  synchronization  by 
knowing  the  phase  relation  of  the  signals  sent  to  both  of 
them  To  further  understand  the  circuit  of  Figure  2-5  notice 
the  PLL  Module  (U8)  This  chip  develops  a  12  672  MHz  sig- 
nal which  is  phase  locked  to  the  1  2672  MHz  input  on  pin  5 
and  is  a  divide  by  16  of  the  primary  20  2752  MHz  clock 
This  provides  the  Gate  Array  4,1  1  with  two  clocks  to  drive 
the  video  display  and  the  graphics  circuits,  10  1376  MHz  for 
64  character  display,  and  a  12  672  MHz  for  the  80  character 
display. 

The  following  discussion  will  consider  both  the  64  and  80 
character  displays  to  be  the  same,  the  difference  being  the 
primary  frequency  and  not  the  phase  relation  or  function  of 
the  signals  generated 

The  reference  clock  for  the  timing  is  DCLK  (U9-15)  and  the 
other  clocks  that  are  produced  for  the  video  output  are  de- 
rived from  this  clock  (DOT*  at  U9-17  is  a  phase  shift  of 
DCLK  and  is  provided  as  an  option  for  the  the  dot  clock  for 
variations  in  delay  paths  in  the  video  section)  U9  then  gen- 
erates SHIFT*  (pin  21),  XADR7*  (pin  20),  CRTCLK  (pin  19), 
LOADS*  (pin  18),  and  LOAD*  (pin  16)  for  the  proper  timing 
for  the  four  video  modes  In  addition  for  the  Graphics  Board 
to  synchronize  with  this  timing  H  (pin  14),  I  (pin  13),  and  J 
(pin  11}  are  fed  to  connector  J12  See  Figures  2-6  and  2-7 
for  the  timing  diagrams  for  video  clocks  generated  by  Gate 
Array  4  11 
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Figure  2-4.  Control  Registers 
(Page  2  of  Schematic) 
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Figure  2-5.  CPU,  RS232C,  and  Video 

Timing  Generation 

(Page  3  of  Schematic) 
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DRAM  and  Video  RAM  Timing 

The  Video  RAM  and  DRAM  timing  share  the  timing  delay 
line  (U80)  This  is  done  by  "OR  ing  the  two  signals  GRAS*, 
and  A1NPRG*  at  U39  to  get  the  signal  STDELV  This  is  pos- 
sible because  the  signals  VIDEO  and  MREQ  or  MCYCEN 
are  gated  in  to  mask  off  the  signals  that  are  not  desired 

Since  the  CRTC  and  the  CPU  are  operating  independently 
and  at  different  clock  rates,  when  the  CPU  wants  to  access 
the  Video  RAM  the  two  must  synchronize  with  each  other 
This  is  accomplished  when  a  video  access  is  decoded 
WAIT'  it  is  pulled  low,  when  it  is  determined  whether  the  ac- 
cess is  a  read  or  write  and  the  correct  cycle  of  the  CRTC 
clock  is  present,  the  actual  access  can  begin,  hence 
A1NPRG*  is  generated  and  WAIT*  is  released 

From  this  point  the  actual  sequence  depends  on  whether  a 
read  or  a  write  is  done  On  a  read  the  address  is  enabled  to 
the  RAM,  the  delay  through  U80  to  VLATCH*  when  data  is 
latched  in  the  74LS373  where  the  CPU  can  pick-up  the  data 

HI   1MB  (JUnipiwttUM  Ut   it'iii  CyCie.   Oi'i  a  Wi'iie?  iSic   SeCjuwnCS  iS 

more  complex  The  address  is  enabled  to  the  RAM,  the  out- 
put is  disabled  (VRAMDIS*  at  U7-12),  write  is  delayed  with 
respect  to  the  address  (DLYWR*  at  U60-6)  and  the  buffer  on 
the  data  lines  is  enabled  (VBUFEN*  at  U60-8),  then  after  a 
delay  the  write  is  cutoff  to  end  the  cycle  for  the  RAM 
(ENDVW*  at  U80-10)  For  the  timing  diagram  of  the  Video 
RAM  CPU  access  see  Figure  2-8, 


DRAM  Timing 

The  DRAM  timing  is  shown  in  Figure  2-9  At  the  begining  of 
the  CPU  cycle  the  address  lines  settle-out  first  and  are, 
therefore,  decoded  to  allow  maximum  access  speed  (see 
Address  Decode),  With  the  generation  of  MREQ,  U39-11 
generates  PMREQ  and  enables  U42  and  gates  this  with  the 
type  of  cycle  to  develop  GRAS*  (U30-6),  RASO*  (U30-3), 
and  RAS1*  (U30-11)  GRAS"  is  then  "OR 'ed  with  AINPRG 
as  mentioned  above.  The  timing  from  this  point  is  very 
straight  forward.  With  RASO*  and  RAS1*  generated  next 
MUX  (U80-12)  is  built  to  switch  the  addresses  to  memory 
then  GCAS  is  generated  and  clocks  flip-flop  U31  with 
MCYEN  on  the  J  term  This  is  done  to  make  sure  this  is  a 
true  memory  cycle.  Then  if  this  is  an  M1  cycle  VLATCH" 
clocks  at  U31  and  cuts  off  PMREQ*  at  U39  to  end  the  cycle 
For  timing  diagrams  of  the  memory  interlace  see  Figures  2- 
10  to  2-12 

2.1.5.  Address  Decode 

This  sscilon  is  divided  into  two  n?.rts  the  m^mon'  ^ddrf1^- 
ing  and  the  I/O  addressing.  This  separation  is  a  reflection  of 
the  separate  mapping  of  memory  and  I/O  of  the  Z80A  itself 
For  reference  of  both  sections,  see  Figure  2-13 

Memory  Address 

The  memory  map  for  the  Mode!  4  is  shown  in  Table  2-1  and 
is  best  described  as  an  option  overlay  in  the  sense  that  at 
each  step  of  additional  memory,  the  new  options  overlap  the 
previous  and  the  new  options  are  added  on  Moreover,  the 
added  options  have  no  effect  on  previous  levels  and  are  in- 
visible at  those  levels. 


MAPI* 


Address  in  hex 
MAP  II  MAP  III 


MAP  IV 


Function 
of  block 


0000-37E7 

37E8-37E9 

37EA-37FF 

3800-3BFF 

3C00-3FFF*' 

4000-7FFF 

4000-FFFF 


0000-37FF 


3800-3BFF 
3C00-3FFF** 


4000-FFFF 


0000-F3FF 


F400-F7FF 
F800-FFFF 


0000-FFFF 


RAM  (64K) 
ROM 

Printer  Status 
ROM 
Keyboard 
Video  RAM 
RAM  (16K) 
RAM  (64K) 


Table  2-1 


"  Only  map  available  on  16K  machine 

*  Page  bit  is  used  to  select  1 K  of  2K  Video  RAM 


The  decoding  of  the  addresses  for  the  memory  map  de- 
scribed above  is  done  for  the  most  part  by  U5  The  only  de- 
code not  done  by  U5  is  the  line  printer  memory  status  port 
at  37E8  and  37E9  hex.  These  needed  additional  address 
lines  hence  the  decode  LPADD  as  an  input  to  U5 
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Figure  2-9.  Video  RAM  and  DRAM  Timing  Circuit. 
(Page  2  of  Schematic) 
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I/O  port  Address 


The  Port  Map  decoding  is  accomplished  by  three  74LS138S 
(U43,U44,  and  U59),  These  ICs  decode  the  low  order  ad- 
dress lines  (AO  -  A7)  from  the  CPU  and  decode  the  port 
being  selected  The  IN*  signal  and  OUT"  signal  are  used  in 
the  decode  for  U59  and  U43,  but  U44  is  a  pure  address  de- 
code and,  therefore,  needs  to  be  gated  with  IN*,  OUT*,  or 
IOREQ*  later  For  a  complete  I/O  map  see  Table  2-3 


The  Model  4  aiso  has  an  option  for  either  64  character  or  80 
character  wide  screen  The  64  character  screen  is  compati- 
ble with  the  Model  III  and  displays  16  lines  The  80  charac- 
ter screen  displays  24  lines  In  addition  each  of  these  has  a 
double  width  mode  These  options  are  controlled  by  two  bits, 
MODSEL  and  8064  which  provide  the  screens  as  shown  in 
the  following  table 


2.1.6.  ROM 

The  A  ROM  is  enabled  by  the  decode  as  appropriate  by  the 
address  logic  described  above,  and  is  addressed  in  a  simple 
straight  forward  fashion  The  enable  for  the  B/C  ROM  is  also 
similarly  accomplished,  however,  the  address  has  a  jumper 
option  available  This  option  is  designed  to  allow  for  testing 
of  the  board  logic  in  the  factory  When  jumper  is  moved  from 
JP8  to  JP7,  the  ROM  is  in  the  test  mode,  with  the  options 
appearing  on  the  screen 


8064 


MODSEL 


Video  Screen  Size 


64x16 
32x16 
80x24 
40x24 


Table  2-4 


t.y.i  uriHivi 

The  DRAM  timing  was  described  earlier  in  the  timing  sec- 
tion, the  actual  DRAM  is  contained  in  two  banks  of  eight 
each  U65  to  U74  and  U85  to  U92  They  are  arranged  in  or- 
der of  data  bits  DO  through  D7,  U65  and  U85  being  DO, 
through  U74  and  U92  being  D7,  Note  in  Figure  2-15  that  the 
two  banks  are  different  with  jumper  options  in  the  lower 
bank,  these  options  are  for  the  possible  use  of  16k  three 
voltage  parts  When  jumpered  as  shown  in  Figure  2-14  the 
bank  is  identical  to  the  second  bank  and  is  for  using  64k 
DRAMs  With  both  banks  filled  there  is  128k  available  to  the 
user. 

2.1.8  Video  Circuit 

Video  Modes 

The  Model  4  has  many  video  options  available  through 
hardware  and  software  Software  has  control  of  inverse 
video  on  a  character  by  character  basis  by  turning  on  IN- 
VIDE,  Note  that  this  implies  the  available  number  of  charac- 
ters is  now  128  since  the  most  significant  bit  of  the  character 
code  in  memory  is  now  used  to  indicate  inverse  character 
Similarly,  an  alternate  character  set  can  be  enabled  by  turn- 
ing on  ENALTSET  This  enables  a  new  64  characters  in 
place  of  the  last  64  characters,  that  is,  the  Kana  set  in  place 
of  the  game  set.  An  option  not  available  to  software  is  an 
enhanced  character,  which  moves  characters  down  one  row 
in  their  character  block  to  make  an  inverse  character  appear 
within  the  inverse  block  and  not  on  the  edge  of  the  block 
This  is  done  by  moving  jumper  JP11  to  JP12  As  an  exam- 
ple of  a  combination  of  hardware  and  software  options  avail- 
able in  the  video  is  the  overlay,  which  not  only  requires  the 
Graphics  Board  to  be  installed,  but  aiso  software  to  enable 
the  graphics  data  and  the  video  data  with  text  at  the  same 
time 


With  this  information  of  the  options  available  to  the  user  we 
can  now  view  the  actual  operation  of  the  circuit  with  the  final 
objectives  in  mind  and  see  how  they  are  achieved  For  the 
rest  of  this  section  all  references  will  be  made  to  Figure  2- 
16  The  first  task  to  be  accomplished  would  be  the  screen 
refresh  and  this  is  done  by  the  CRTC  or  68045  (U1 1 )  which 
will  generate  the  addresses  continuously  on  its  address 
lines  Then  to  allow  the  CPU  access  to  the  same  memory 
the  address  lines  are  multiplexed  at  U12,  U14,  and  U15  on 
opposite  phases  of  the  CRT  clock  The  CPUs  access  timing 
is  then  handed  by  the  timing  circuit  described  earlier 

The  data  bus  of  the  RAM  (U16)  is  a  two  way  bus  with  the 
RAM  as  a  source  or  destination  on  all  accesses,  the  video 
gate  array  (U17)  is  the  destination  on  the  screen  refresh  half 
of  the  cycle,  the  74LS373  <U36)  is  the  destination  on  a  read 
of  the  RAM  by  the  CPU,  and  the  74LS244  (U35)  is  the 
source  on  writes  to  the  RAM, 

The  video  gate  array  then  gates  the  RAM  data  fNVIDE,  and 
ENALTSET  to  determine  the  ROM  addressing  for  these  two 
options  and  CHRADD  to  the  74LS283  (U13)  which  takes  the 
row  address  from  the  68045  and  adds  a  zero  to  the  row  ad- 
dress or  a  minus  one  to  form  the  character  enhanced  mode, 

The  data  out  of  the  ROM  is  then  sent  back  to  the  gate  array 
where  it  is  then  changed  to  a  serial  stream  of  data  which  is 
synchronized  with  the  data  that  would  come  from  the  graph- 
ics board,  GRAFVID.  The  signal  CL166  will  inhibit  the  data 
out  of  the  serial  register  and  the  signal  ENGRAF  enables 
the  graphics  data,  hence,  if  both  are  enabled  the  effect  is  an 
overlay  The  output  data  is  sent  to  U20  pin  9  where  it  is 
gated  with  one  of  two  phases  of  the  dot  clock;  then  after 
being  filtered  to  lower  the  R..F.I.  it  is  output  to  the  sweep 
board 
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Port 

D7 

FC-FF 

Cass 

(READ) 

data 

500  bd 

FC-FF 

(WRITE) 

X 

F8-FB 

Prntr 

(READ) 

BUSY 

F8-  FB 

Prntr 

(WRITE) 

D7 

Prntr 
Paper 


Prntr 
D6 


Model  4  Port  Bit  Map 
D4  D3 


(MIRROR   of   PORT      EC) 


(Note,  also  resets  cassette  data  tatch) 


Prntr 
Select 


Prntr 
D5 


Prntr 
Fault 


Prntr 
D4 


Prntr 
D3 


Prntr 
D2 


Prntr 
D1 


DO 

Cassette 


data 
1500bd 


cassette 
data  out 


Prntr 
DO 


{Any  Read  causes  reset  of  Real  Time  Clock  Interrupt) 


EC-EF 
(WRITE) 


E0-E3 
(READ) 


E0-E3 
(WRITE) 


CPU 

X 

Enable 

Enable 

Fast 

X 

EX  I/O 

Altset 

Receive 

Receive 

Xmit 

10  Bus 

Error 

Data 

Empty 

Int 

Enable 

Enable 

Enable 

Enable 

Rec  Err 

Rec  Data 

Xmit  Emp 

10  Int 

Mode 
Select 


RTC 
Int 


Enable 
RTInt 


Cass 
Mot  On 


C  Fall 
Int 


Enable 
CF  Int 


Enable 
CR  fnt 


90-93 
(WRITE) 


Sound 
Bit 


84-87 
(WRITE) 


Page 


Fix  Upr 
Memory 


Memory 

Bit  1 


Memory 
BitO 


invert 
Video 


80/64 


Select 
Bit  1 


Select 
BitO 


Table  2-3.  I/O  Port  Map 
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Figure  2-14.  ROM  Circuit 
(Page  1  of  Schematic) 
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2,1.9  Keyboard 


Pin  Number         Signature 


The  interface  to  the  keyboard  is  a  matrix  composed  of  ad- 
dress lines  in  one  direction  and  data  iines  in  the  other  The 
address  lines  have  two  open  collector  buffers  (U26  and  U4Q) 
on  the  output  to  the  keyboard 

The  input  is  pulled-up  with  an  820  ohm  resistor  and  is  then 
fed  into  two  CMOS  Inputs  (U55  and  U56)  which  act  as  a 
driver  on  data  lines 

2.1.10  Real  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4  provides  a  30  Hz 
(in  the  2  MHz  CPU  Mode)  or  60  Hz  (in  the  4  MHz  CPU 
Mode)  interrupt  to  the  CPU  By  counting  the  number  of  inter- 
rupts that  have  occured,  the  CPU  can  keep  track  of  the 
time-  The  60  Hz  vertical  sync  signal  from  the  video  circuitry 
is  divided  by  two  (2  MHz  Mode)  by  U10  and  the  30  Hz  at 
pin  9  of  U46  is  used  to  generate  the  interrupts  In  the  4  MHz 
mode,  the  signal  FAST  places  a  logic  low  at  pin  4  of  U10, 
causing  the  signal  VSYNC  to  pass  through  U46  at  its  normal 
rate  and  trigger  interrupts  at  the  60  Hz  rate  Note  that  any 
time  interrupts  are  disabled,  the  accuracy  of  the  clock 
suffers 

2.1.11  Line  Printer  Port 

The  printer  status  lines  are  read  by  the  CPU  by  enabling 
buffer  U108.  This  buffer  will  be  enabled  for  any  input  from 
port  F8  or  F9,  or  any  memory  read  from  location  37E8  or 
37E9  when  in  the  Model  Ell  mode.  For  a  listing  of  bit  status, 
refer  to  the  bit  map 

After  the  printer  driver  software  determines  that  the  printer  is 
ready  to  receive  a  character  (by  reading  the  status),  the 
character  to  be  printed  is  output  to  port  F8  This  latches  the 
character  into  U107,  and  simultaneously  fires  the  one-shot 
U63  to  provide  the  appropriate  strobe  to  the  printer 

2.1.12  Graphics  Port 

The  graphics  port  on  the  Model  4  is  provided  to  attach  the 
optional  high  resolution  graphics  board  and  provides  the 
necessary  signals  to  interface  not  only  to  the  CPU  (such  as 
data  lines,  address  iines,  address  decodes,  and  control 
lines),  but  also  the  signals  needed  to  synchronize  the  output 
of  the  Video  Circuit  and  the  Graphics  board  and  control  to 
provide  features  such  as  overlay 
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5 

D4 

6 

D5 
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D7 
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DCLK 

11 
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12 

A1 

13 

A2 

14 

J 

15 

GRAPVID 

16 

ENGRAF 

17 

DISBEN 

18 

VSYNC 

19 
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RESET* 

21 

WAIT* 

22 
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25 
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26 
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27 
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Figure  2-17.  Keyboard 
(Page  4  of  Schematic) 
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Figure  2-18.  RTC 
(Page  4  of  Schematic) 
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Figure  2-19.  Printer  Circuit 
(Page  4  of  Schematic) 
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Figure  2-20.  Sound 
(Page  4  of  Schematic) 
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2.1.13  Sound  Port 

The  sound  circuit  is  compatible  with  the  optional  sound 
board  on  the  older  version  of  the  Model  4,  and  works  in  a 
similar  fashion.  Sound  is  generated  by  setting  and  clearing 
data  bit  zero  on  successive  OUTs  to  port  90H  The  state  of 
DO  is  latched  in  U18  which  is  amplified  by  Q2  to  drive  the 
speaker  (SP1), 

2.1.14  I/O  Bus  Port 

The  Model  4  Gate  Array  Bus  is  designed  to  ailow  easy  and 
convenient  interfacing  of  I/O  devices  to  the  Model  4.  The  i/O 
Bus  supports  all  the  signals  necessary  to  implement  a  de- 
vice compatible  with  the  Z-80s  I/O  structure  That  is: 


AO  to  A7  allow  selection  of  up  to  256  input  and  256  output 
devices  if  external  I/O  is  enabled 

Ports  BOH  to  OFFH  are  reserved  for  System  use 

Data: 

DBO  to  DB7  allow  transfer  of  8-bit  data  onto  the  pro- 
cessor data  bus  if  external  I/O  is  enabled 

Control  Lines: 

a  IN*  —  Z-80  signal  specifying  that  an  input  is  in 
progress  Gated  with  IORQ 

b  OUT'  —  Z-80  signal  specifying  that  an  output  is  in 
progress  Gated  with  IORQ 

c  RESET*  —  system  reset  signal, 

d  IOBUSINT*  —  input  to  the  CPU  signaling  an  inter- 
rupt from  an  I/O  Bus  device  if  I/O  Bus  interrupts  are 
enabled, 

e.  IOBUSWAIT*  —  input  to  the  CPU  wait  line  allowing 
I/O  Bus  device  to  force  wait  states  on  the  Z-80  if 
external  f/O  is  enabled 

f  EXTIOSEL*  —  input  to  CPU  which  switches  the  I/O 
Bus  data  bus  transceiver  and  allows  an  INPUT  in- 
struction to  read  I/O  Bus  data 

g  M1*  —  and  IORQ*  —  standard  Z-80  signals 

The  address  line,  data  line,  and  contra!  lines  a  to  c  and  e  to 
g  are  enabled  oniy  when  the  ENEXIO  bit  is  set  to  a  one 


To  enable  I/O  interrupts,  the  ENIOBUSINT  bit  in  the  CPU  10- 
PORT  EO  (output  port)  must  be  a  one.  However,  even  if  it  is 
disabled  from  generating  interrupts,  the  status  of  the  IOBU- 
SINT* line  can  still  read  on  the  appropriate  bit  of  CPU  IO- 
PORT  EO  (input  port) 

See  Model  4  Port  Bit  assignment  for  OFF,  OEC,  and  0E0 

The  Model  4  CPU  board  is  fully  protected  from  foreign  I/O 
devices  in  that  all  the  I/O  bus  signals  are  buffered  and  can 
be  disabled  under  software  control.  To  attach  and  use  an  i/O 
device  on  the  I/O  Bus,  certain  requirements  (both  hardware 
and  software)  must  be  met 

For  input  port  device  use,  you  must  enable  external  I/O  de- 
vices by  writing  to  port  OECH  with  bit  4  on  in  the  user  soft- 
ware This  will  enable  the  data  bus,  address  lines,  and 
control  signals  to  the  I/O  Bus  edge  connector.  When  the  in- 
put device  is  selected,  the  hardware  will  acknowledge  by  as- 
serting EXTIOSEL"  low  This  switches  the  data  bus 
transceiver  and  allows  the  CPU  to  read  the  contents  of  the  I/ 
O  Bus  data  lines  See  Figure  2-21  for  the  timing  EXTIO- 
SEL* can  be  generated  by  NANDing  !M  and  the  !'0  port 
address 

Output  port  device  use  is  the  same  as  the  input  port  device 
in  use,  in  that  the  externa!  I/O  devices  must  be  enabled  by 
writing  to  port  OECH  with  bit  4  on  in  the  user  software  —  in 
the  same  fashion 

For  either  input  or  output  devices,  the  IOBUSWAIT*  control 
line  can  be  used  in  the  normal  way  for  synchronizing  slow 
devices  to  the  CPU  Note  that  since  dynamic  memories  are 
used  in  the  Mode!  4,  the  wait  line  should  be  used  with  cau- 
tion Holding  the  CPU  in  a  wait  state  for  2  msec  or  more 
may  cause  loss  of  memory  contents  since  refresh  is  inhib- 
ited during  this  time  It  is  recommended  that  the  IOBUS- 
WAIT* line  be  held  active  no  more  than  500  msec  with  a 
25%  duty  cycle 

The  Model  4  will  support  Z-80  mode  1  interrupts  A  RAM 
jump  table  is  supported  by  the  LEVEL  II  BASIC  ROMs  and 
the  user  must  supply  the  address  of  his  interrupt  service 
routine  by  writing  this  address  to  locations  403E  and  403F 
When  an  interrupt  occurs,  the  program  will  be  vectored  to 
the  user  supplied  address  if  I/O  Bus  interrupts  have  been 
enabled  To  enable  I/O  Bus  interrupts,  the  user  must  set  bit 
3  of  Port  0E0H 

The  actual  implementation  is  shown  in  Figure  2-22  The  data 
is  buffered  in  both  directions  using  a  74LS245  (U101),  The 
addresses  are  buffered  with  a  74LS244  (U102),  and  the 
control  lines  out  are  buffered  by  a  74LS367,  Note  that  RE- 
SET* is  always  enabled  out,  this  is  to  power-up  reset  any 
device  or  clear  any  device  before  enabling  the  bus  structure. 
This  prevents  any  user  from  tying-up  the  bus  when  enabling 
the  port  in  an  unknown  state 
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Figure  2-21.  I/O  BUS  TIMING  DIAGRAM 
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Figure  2-22.  I/O  Port 
(Page  4  of  Schematic) 
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Data  Bit 

DO 
D1 
D2 
D3 
D4 

D5 


D6 
D7 


Function 

Selects  Drive  0  when  set* 
Selects  Drive  1  when  set* 
Selects  Drive  2  when  set* 
Selects  Drive  3  when  set* 
Selects  Side  0  when  reset 
Selects  Side  1  when  set 
Write  precompensation 
enabled  when  set  dis- 
abled when  reset 
Generates  WAIT  if  set 
Selects  MFM  mode  it  set 
Selects  FM  mode  if  reset 


"Only  one  of  these  bits  should  be  set  per  output 

Hex  D  flip-flop  U79  (74L174)  latches  the  drive  select  bits, 
side  select  and  FM*  MFM  bits  on  the  rising  edge  of  the  con- 
trol signai  DRVSEL*  Gate  Array  44(U76)  is  used  to  latch 
the  Wait  Enable  and  Write  precompensation  enable  bits  on 
the  rising  edge  of  DRVSEL*.  The  rising  edge  of  DRVSEL* 
also  triggers  a  one-shot  (Internal  to  U76)  which  produces  a 
Motor  On  to  the  disk  drives  The  duration  of  the  Motor  On 
signal  is  approximately  three  seconds  The  spindle  motors 
are  not  designed  for  continuous  operation-  Therefore,  the  in- 
active state  of  the  Motor  On  signal  is  used  to  clear  the  Drive 
Select  Latch,  which  de-selects  any  drives  which  were  previ- 
ously selected  The  Motor  On  one-shot  is  retriggerable  by 
simply  executing  another  OUT  instruction  to  the  Drive  Select 
Latch, 

Wait  State  Generation  and  WAITIMOUT  Logic 

As  previously  mentioned,  a  wait  state  to  the  CPU  can  be  ini- 
tiated by  an  OUT  to  the  Drive  Select  Latch  with  D6  set  Pin 
10  of  U76  will  go  high  after  this  operation  This  signal  is  in- 
verted by  1/4  of  U96  and  is  routed  to  the  CPU  where  it 
forces  the  Z80A  into  a  wait  state  The  Z80A  will  remain  in 
the  wait  state  as  long  as  WAIT*  is  low  Once  initiated,  the 
WAIT*  will  remain  low  until  one  of  five  conditions  is  satisfied 
If  INTRQ,  DRQ,  or  RESET  inputs  become  active  (logic 
high),  it  causes  WAIT*  to  go  high  which  allows  the  Z80  to 
exit  the  wait  state  An  internai  timer  on  U70  serves  as  a 
watchdog  timer  to  insure  that  a  wait  condition  will  not  persist 
long  enough  to  destroy  dynamic  RAM  contents-  This  internal 
watchdog  timer  logic  will  limit  the  duration  of  a  wait  to  1024 
jjisec,  even  if  the  FDC  chip  should  fail  to  generate  a  DRQ  or 
an  INTRQ 


Clock  Generation  Logic 

A  16  MHz  crystal  oscillator  and  Gate  Array  4,4  (U76)  are 
used  to  generate  the  clock  signals  required  by  the  FDC 
board  The  16  MHz  oscillator  is  implemented  internal  to  U76 
and  a  quartz  crystal  (Y2)  The  output  of  the  oscillator  is  di- 
vided by  2  to  generate  on  8  MHz  clock  This  is  used  by  the 
FDC  1773  (U75)  for  all  internal  timing  and  data  separation 
U76  further  divides  the  16  MHz  clock  to  drive  the  watchdog 
timer  circuit 

Disk  Bus  Output  Drivers 

High  current  open  collector  drivers  U96,  94  and  93  are  used 
to  buffer  the  output  signals  from  the  FDC  circuit  to  the  disk 
drives 

Write  Precompensation  and 
Write  Data  Pulse  Shaping  Logic 

All  write  precompensation  is  generated  internal  to  the  FDC 
chip  1773  (U75)  Write  Precompensation  occurs  when  WG 
goes  high  and  write  precompensation  is  enabled  from  the 
software,  ENP  is  multiplexed  with  RDY  and  is  controlled  by 
WG  at  pin  20  of  U75  Write  data  is  output  on  pin  22  of  U75 
and  is  shaped  by  a  one-shot  (1/2  of  U98)  which  stretches 
the  data  pulses  to  approximately  500  nsec 

Clock  and  Read  Data  Recovery  Logic 

The  Clock  and  Read  Data  Recovery  Logic  is  done  interna! 
to  the  1773  (U75) 

Floppy  Disk  Controller  Chip 

The  1773  Is  an  MOS  LSI  device  which  performs  the 
functions  of  a  floppy  disk  formatter/controller  in  a  sin- 
gle chip  implementation.  The  following  port  addresses 
are  assigned  to  the  Internal  registers  of  the  1773  FDC 
chip: 


art  No. 

Function 

F0H 

Command/Status 

Register 

F1H 

Track  Register 

F2H 

Sector  Register 

F3H 

Data  Register 

If  an  OUT  to  Drive  Select  Latch  is  initiated  with  D6  reset 
(logic  low),  a  WAIT  is  still  generated  The  internal  timer  on 
U70  will  count  to  2  which  will  clear  the  WAIT  state  This  al- 
lows the  WAIT  to  occur  only  during  the  OUT  instruction  to 
prevent  violating  any  Dynamic  RAM  parameters 

NOTE:  This  automatic  WAIT  will  cause  a  5  to  1  p,sec  wait 
each  time  an  out  to  Drive  Select  Latch  is  performed 
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2.1.15  Cassette  Circuit 


Control  and  Data  Buffering 


The  cassette  write  circuitry  latches  the  two  LSBs  (DO  and 
D1)  for  any  output  to  port  FF  (hex)  The  outputs  of  these 
latches  (U51 )  are  then  resistor  summed  to  provide  three  dis- 
crete voitage  levels  (500  Baud  only)  The  firmware  toggles 
the  bits  to  provide  an  output  signal  of  the  desired  frequency 
at  the  summing  node 

There  are  two  types  of  cassette  Read  circuits  —  500  baud 
and  1500  baud  The  500  baud  circuit  is  compatible  with  both 
Model  I  and  111  The  input  signal  is  amplified  and  filtered  by 
Op  amps  (U23  and  U54)  Part  of  U22  then  forms  a  Zero 
Crossing  Detector,  the  output  of  which  sets  the  latch  U37,  A 
read  of  Port  FF  enables  buffer  U52  which  allows  the  CPU  to 
determine  whether  the  latch  has  been  set,  and  simultane- 
ously resets  the  latch  The  firmware  determines  by  the  tim- 
ing between  settings  of  the  latch  whether  a  logic  "one"  or 
'"zero"  was  read  in  from  the  tape. 

The  1500  baud  cassette  read  circuit  is  compatible  with  the 
Model  ill  cassette  system  The  incoming  signal  is  compared 
to  a  threshold  by  part  of  U22  U22  s  output  will  then  be 
either  high  or  low  and  clock  about  one-half  of  U37t  depend- 
ing on  whether  it  is  a  rising  edge  or  a  falling  edge  if  inter- 
rupts are  enabled,  the  setting  of  either  latch  will  generate  an 
interrupt.  As  in  the  500  baud  circuit,  the  firmware  decodes 
the  interrupts  into  the  appropriate  data 

For  any  cassette  read  or  write  operation,  the  cassette  relay 
must  be  closed  in  order  to  start  the  motor  of  the  cassette 
deck  A  write  to  port  EC  hex  with  bit  one  set  will  latch  U53, 
which  turns  on  transistor  Q3  and  energizes  the  relay  K1  A 
subsequent  write  to  this  port  with  bit  one  clear  will  clear  the 
latch  and  de-energize  the  relay. 

2.1.16  FDC  Circuit 

The  TRS-80  Model  4  Floppy  Disk  interface  provides  a  stan- 
dard 5-1/4"  floppy  disk  controller  The  Floppy  Disk  interface 
supports  single  and  double  density  encoding  schemes  Write 
precompensation  can  be  software  enabled  or  disabled  be- 
ginning at  any  track,  although  the  system  software  enables 
write  precompensation  for  all  tracks  greater  than  twenty-one 
The  amount  of  write  precompensation  is  125  nsec  and  is  not 
adjustable.  One  to  four  drives  may  be  controlled  by  the  in- 
terface All  data  transfers  are  accomplished  by  CPU  data  re- 
quests In  double  density  operation,  data  transfers  are 
synchronized  to  the  CPU  by  forcing  a  wait  to  the  CPU  and 
clearing  the  wait  by  a  data  request  from  the  FDC  chip.  The 
end  of  the  data  transfer  is  indicated  by  generation  of  a  non- 
maskable interrupt  from  the  interrupt  request  output  of  the 
FDC  chip  A  hardware  watchdog  timer  insures  that  any  error 
condition  will  not  hang  the  wait  line  to  the  CPU  for  a  period 
long  enough  to  destroy  RAM  contents. 


The  Floppy  Controller  is  an  i/O  port-mapped  device  which 
utilizes  ports  E4H,  F0H,  F1H,  F2H,  F3H(  and  F4H.  The  de- 
coding logic  is  implemented  in  the  Address  Decoding  (for 
more  information  see  Port  Map)  U78  is  a  bi-directional,  8-bit 
transceiver  used  to  buffer  data  to  and  from  the  FDC  and 
RS-232  circuits  The  direction  of  data  transfer  is  controlled 
by  the  combination  of  control  signals  DlSKIN\  RDINTSTA- 
TUS*.  RDNINSTATUS",  and  RS232IN*  If  any  signal  is  active 
(logic  low),  U78  is  enabled  to  drive  data  onto  the  CPU  data 
bus  If  all  signals  are  inactive  (logic  high),  U78  is  enabled  to 
receive  data  from  the  CPU  board  data  bus  A  second  buffer 
U77  is  used  to  buffer  the  FDC  chip  data  to  the  FDC/RS232 
Data  Bus,  (BD0-BD7)  U77  is  enabled  by  Chip  Select  and  its 
direction  controlled  by  DISKIN*  Again,  if  DISKIN"  is  active 
(logic  low),  data  is  enabled  to  drive  from  the  FDC  chip  to  the 
Main  Data  Busses  If  DISKIN"  is  inactive  (logic  high),  data  is 
enabled  to  be  transferred  to  the  FDC  chip 

Non-maskable  Interrupt  Logic 


on  the  rising  edge  of  the  control  signal  WRNMIMASKREG* 
This  enables  the  conditions  which  will  generate  a  non-mask- 
able interrupt  to  the  CPU  The  NMI  interrupt  conditions 
which  are  programmed  by  doing  an  OUT  instruction  to  port 
E4H  with  the  appropriate  bits  set  If  data  bit  7  is  set,  an  FDC 
interrupt  is  enabled  to  generate  an  NMI  interrupt  If  data  bit 
7  is  reset,  interrupt  requests  from  the  FDC  are  disabled.  If 
data  bit  6  is  set,  a  Motor  Time  Out  is  enabled  to  generate  an 
NMI  interrupt.  If  data  bit  6  is  reset,  interrupts  on  Motor  Time 
Out  are  disabled.  An  IN  instruction  from  port  E4H  enables 
the  CPU  to  determine  the  course  of  the  non-maskable  inter- 
rupt Data  bit  7  indicates  the  status  of  FDC  interrupt  request 
(INTRQ)  (0  =  true,  1  =  false)  Data  bit  6  indicates  the  status 
of  Motor  Time  Out  (0  =  true,  1  =  false)  Data  bit  5  indicates 
the  status  of  the  Reset  signal  (0  =  true,  1  -  false)  The  con- 
trol signal  RDNMiSTATUS*  gates  this  status  onto  the  CPU 
data  bus  when  active  (logic  low), 

Drive  Select  Latch  and  Motor  ON  Logic 

Selecting  a  drive  prior  to  disk  I/O  operation  is  accomplished 
by  doing  an  OUT  instruction  to  port  F4H  with  the  proper  bit 
set  The  following  table  describes  the  bit  allocation  of  the 
Drive  Select  Latch : 
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2/U7  RS-232C  Circuit 


RS-232C  Technical  Description 


The  RS-232C  circuit  for  the  Model  4  computer  supports 
asynchronous  serial  transmissions  and  conforms  to  the  ESA 
RS-232C  standards  at  the  input-output  interface  connector 
(J3)  The  heart  of  the  circuit  is  the  TR1865  Asynchronous 
Receiver/Transmitter  U84  It  performs  the  job  of  converting 
the  parallel  byte  data  from  the  CPU  to  a  serial  data  stream 
including  start,  stop,  and  parity  bits  For  a  more  detailed  de- 
scription of  how  this  LSI  circuit  performs  these  functions,  re- 
fer to  the  TR1865  data  sheets  and  application  notes.  The 
transmit  and  receive  clock  rates  that  the  TR1865  needs  are 
supplied  by  the  Baud  Rate  Generator  U104  This  circuit 
takes  the  5,0688  MHz  supplied  by  the  system  timing  circuit 
and  the  programmed  information  received  from  the  CPU 
over  the  data  bus  and  divides  the  basic  clock  rate  to  provide 
two  clocks  The  rates  available  from  the  BRG  go  from  50 
Baud  to  19200  Baud  See  the  BRG  table  for  the  complete 
list. 


Interrupts  are  supported  in  the  RS-232C  Circuit  by  the  Inter- 
rupt mask  register  and  the  Status  register  internal  to  Gate 
Array  4  5  (U82)  The  CPU  looks  here  to  see  which  kind  of 
interrupt  has  occurred  Interrupts  can  be  generated  on  re- 
ceiver data  register  full,  transmitter  register  empty,  and  any 
one  of  the  errors  —  parity,  framing,  or  data  overrun.  This  al- 
lows a  minimum  of  CPU  overhead  in  transferring  data  to  or 
from  the  UART.  The  interrupt  mask  register  is  port  E0  (write) 
and  the  interrupt  status  register  is  port  E0  (read).  Refer  to 
the  IO  Port  description  for  a  full  breakdown  of  all  interrupts 
and  their  bit  positions. 

All  Model  I,  III,  and  4  software  written  for  the  RS-232C  inter- 
face is  compatible  with  the  Model  4  Gate  Array  RS-232C  cir- 
cuit, provided  the  software  does  not  use  the  sense  switches 
to  configure  the  interface  The  programmer  can  get  around 
this  problem  by  directly  programming  the  BRG  and  UART  for 
the  desired  configuration  or  by  using  the  SETCOM  com- 
mand of  the  disk  operating  system  to  configure  the  interface 
The  TRS-80  RS-232C  Interface  hardware  manual  has  a 
good  discussion  of  the  RS-232C  standard  and  specific  pro- 
gramming examples  (Catalog  Number  26-1145) 


BRG  Programming  Table 


Nibble 
Loaded 

OH 
1H 
2H 
3H 
4H 
5H 
6H 
7H 
8H 
9H 
AH 
BH 
CH 
DH 
EH 
FH 


Transmit/ 
Receive 

Baud 

Rate 

50 
75 

110 

134.5 

150 

300 

600 
1200 
1800 
2000 
2400 
3600 
4800 
7200 
9600 
19200 


16X 
Clock 

0.8  kHz 

1.2  kHz 

1.76  kHz 

2  1523  kHz 

2  4  kHz 

4.8  kHz 

9.6  kHz 

19,2  kHz 

28.8  kHz 

32.081  kHz 

38.4  kHz 

57.6  kHz 

76.8  kHz 

1152  kHz 

153,6  kHz 

307.2  kHz 


Suported 

SETCOM 

Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 


Pinout  Listing 


The  RS-232C  circuit  is  port  mapped  and  the  ports  used  are 
E8  to  EB  Following  is  a  description  of  each  port  on  both  in- 
put and  output 


Port 

Input 

Output 

E8 

Modem  status 

Master  Reset,  enables 
UART  control  register 
load 

EA 

UART  status 

UART  control  register 
load  and  modem  control 

E9 

Not  Used 

Baud  rate  register  load 

enable  bit 

EB 

Receiver   Holding 

Transmitter     Holding 

register 

register 

The  following  list  is  a  pinout  description  of  the  DB-25  con- 
nector (P1) 

Pin  No.  Signal 

1  PGND  (Protective  Ground) 

2  TD  (Transmit  Data) 

3  RD  (Receive  Data) 

4  RTS  (Request  to  Send) 

5  CTS  (Clear  To  Send) 

6  DSR  (Data  Set  Ready) 

7  SGND  (Signal  Ground) 

8  CD  (Carrier  Detect) 

19  SRTS  (Spare  Request  to  Send) 

20  DTR  (Data  Terminal  Ready) 
22  Rl  (Ring  indicate) 
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Model  4  Gate  Array 
I/O  Pin  Assignments 


J1 


J2 


J3 


J4 


J5 


Pin 

Pin 

Pin 

Pin 

Pin 

No. 

Signal 

No. 

Signal 

No. 

Signal 

No. 

Signal 

No. 

Signal 

1 

GND 

1. 

GND 

1. 

PGND 

1 

XDO 

1. 

XDO 

2. 

2. 

2. 

TD 

2, 

GND 

2. 

GND 

3. 

GND 

3, 

GND 

3. 

RD 

3. 

XD1 

3 

XD1 

4, 

4, 

4. 

RTS 

4. 

GND 

4. 

GND 

5. 

GND 

5, 

GND 

5. 

CTS 

5. 

XD2 

5. 

XD2 

6, 

6, 

6. 

DSR 

6. 

GND 

6. 

GND 

7. 

GND 

7, 

GND 

7., 

SGND 

7. 

XD3 

7. 

XD3 

8, 

IPE* 

8, 

IPI* 

8, 

CD 

8, 

GND 

8. 

GND 

9, 

GND 

9, 

GND 

9, 

9 

XD4 

9 

XD4 

10. 

DS2* 

10, 

DS0* 

10, 

10 

GND 

10. 

GND 

11, 

GND 

11. 

GND 

11 

11 

XD5 

11. 

XD5 

12. 

DS3* 

12, 

DS1* 

12, 

12 

GND 

12. 

GND 

13. 

GND 

13, 

GND 

13. 

13 

XD6 

13. 

XD6 

14. 

14, 

14. 

14 

GND 

14. 

GND 

15. 

GND 

15, 

GND 

15. 

15 

XD7 

15. 

XD7 

16. 

MOTNE* 

16. 

MOTONI* 

16. 

16. 

GND 

16. 

GND 

17. 

GND 

17, 

GND 

17. 

17. 

XA0 

17. 

XA0 

18. 

DIRE* 

18. 

DIRI* 

18. 

18. 

GND 

18. 

GND 

19. 

GND 

19. 

GND 

19. 

SRTS 

19. 

XA1 

19, 

XA1 

20. 

STEPE* 

20. 

STEP!* 

20 

DTR 

20. 

GND 

20, 

GND 

21, 

GND 

21. 

GND 

21, 

21. 

XA2 

21, 

XA2 

22. 

WDE* 

22. 

WDI* 

22. 

Rl 

22. 

GND 

22, 

GND 

23. 

GND 

23. 

GND 

23. 

23. 

XA3 

23 

XA3 

24. 

WGE* 

24, 

WGI* 

24. 

24. 

GND 

24, 

GND 

25. 

GND 

25, 

GND 

25. 

25. 

XA4 

25. 

XA4 

26. 

TRKOE* 

26. 

TRK0I* 

26, 

26. 

GND 

26, 

GND 

27. 

GND 

27., 

GND 

27. 

27, 

XA5 

27, 

XA5 

28. 

WPRTE* 

28., 

WPRTI* 

28, 

28, 

GND 

28, 

GND 

29, 

GND 

29, 

GND 

29. 

29. 

XA6 

29, 

XA6 

30. 

RDE* 

30, 

RDI* 

30, 

30. 

GND 

30, 

GND 

31. 

GND 

31 

GND 

31. 

31. 

XA7 

31, 

XA7 

32. 

SDSELE 

32. 

SDSEL! 

32, 

32, 

GND 

32, 

GND 

33. 

GND 

33., 

GND 

33. 

33, 

XIN* 

33, 

XIN* 

34. 

34. 

34. 

34, 
35. 
36. 
37. 
38., 
39. 
40 
41, 
42 
43, 
44 
45 
46. 
47. 
48. 
49. 
50. 

GND 

xour 

GND 

XRESET* 

GND 

XINT* 

GND 

XWAIT* 

GND 

EXTIO- 

SEL* 

GND 

NC 

GND 

XMI* 

GND 

XIDRQ* 

GND 

34. 
35. 
36. 
37. 
38. 
39., 
40., 
41. 
42, 
43, 
44, 
45, 
46, 
47, 
48 
49. 
50. 

GND 

XOUT* 

GND 

XRESET 

GND 

XINT* 

GND 

XWAIT* 

GND 

EXTIC- 

SEL* 

GND 

NC 

GND 

XMI0 

GND 

XIDRQ* 

GND 
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Model  4  Gate  Array 
I/O  Pin  Assignments 


J6 


J8 


J9 


J12 


Pin 

Pin 

Pin 

Pin 

No.  Signal 

No.  Signal 

No. 

Signal 

No.  Signal 

1. 

1 

1, 

1.   DO 

2    GND 

2. 

2 

GND 

2    D1 

3,   PDO 

3, 

3 

3,    D2 

4,   GND 

4.   VSYNCO* 

4,. 

CASSETTE- 

4    D3 

5.   PD1 

5, 

5. 

IN 

5,   D4 

a  GND 

6,   HSYNCO 

6 

CASSETTE- 

6.   D5 

7    PD2 

7. 

7, 

OUT 

7.   D6 

8    GND 

8 

8. 

8.   D7 

9    PD3 

9. 

9 

9,   GEN* 

10    GND 

10,, 

10, 

10.    DCLK 

11     PD4 

11 

11. 

11.   A0 

12,.  GND 

12 

12. 

12    A1 

13    PD5 

13. 

13 

13,   A2 

14    GND 

14. 

14. 

14    J 

15,   PD6 

15. 

15. 

15.   GRAPVID 

16.  GND 

16, 

16. 

16    ENGRAF 

17.   PD7 

17. 

17, 

17.   DISBEN 

18    GND 

18 

16. 

i6    V3YNG 

19,   N/A 

19 

19. 

19    HSYNC 

20.   GND 

20. 

20 

20.   RESET* 

21     BUSY 

21„ 

21, 

21.   WAIT* 

22   GND 

22 

22,. 

22    H 

23    OUT  PAPER 

23 

23 

23,   ! 

24,   GND 

24, 

24. 

24.   IN* 

25    UNITSEL 

25    GND 

26,   NC 

26,    +5V 

27,   GND 

27,. 

28.   FAULT 

28    CL166 

29 

29    GND 

30 

30,    ~f5V 

31 '   NC 

31,.  GND 

32 

32.    +5V 

33    NC 

33,   GND 

34,   GND 

34,    +5V 
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3.1  MODEL  4P  THEORY  OF  OPERATION 

3.1 .1  Introduction 

Contained  in  the  following  paragraphs  is  a  description  of  the 
component  parts  of  the  Model  4P  CPU  It  is  divided  into  the  log- 
ical operational  functions  of  the  computer  Al!  components  are 
located  on  the  Main  CPU  board  inside  the  case  housing  Refer 
to  Section  3  for  disassembly  assembly  procedures 

3.1.2  Reset  Circuit 

The  Model  4P  reset  circuit  provides  the  neccessary  reset 
pulses  to  all  circuits  during  power  up  and  reset  operations  R25 
and  C21 8  provide  a  time  constant  which  holds  the  input  of  U1 21 
low  during  power-up  This  allows  power  to  be  stable  to  all  cir- 
cuits before  the  RESET*  and  RESET  signals  are  applied  When 
C218  charges  to  a  logic  high,  the  output  of  U121  triggers  the 
input  of  a  retriggerable  one-shot  multivibrator  (U1 }  U1  outputs 
a  pulse  with  an  approximate  width  of  70  microsecs  When  the 
reset  switch  is  pressed  on  the  front  panel,  this  discharges  C218 
and  holds  the  input  of  U121  low  until  the  switch  is  released  On 
release  of  the  switch.  C218agatn  charges  up.  triggering  U121 
and  U1  to  reset  the  microcomputer 

3.1.3  CPU 

The  central  processing  unit  (CPU)  of  the  Model  4P  microcom- 
puter is  a  Z80A  microprocessor  The  Z80A  is  capable  of  run- 
ning in  either  2  MHz  or  4  MHz  mode  The  CPU  controls  all 
functions  of  the  microcomputer  through  use  of  its  address  lines 
(A0-A15).  data  lines  (D0-D7}.  and  control  lines  (  M1 .  IOREQ. 
/RD,  /WR.  /MREQ,  and  RFSH)  The  address  lines  (A0-A15) 
are  buffered  to  other  tCs  through  two  74LS244s  (U68  and  U26) 
which  are  enabled  all  the  time  with  their  enables  pulled  to  GND 
The  control  lines  are  buffered  to  other  ICs  through  a  74F04 
(U86)  The  data  lines  (D0-D7)  are  buffered  through  a  bi-direc- 
tional 74LS245  {U71 )  which  is  enabled  by  BUSEN*  and  the  di- 
rection is  controlled  by  BUSDIR* 

3.1.4  System  Timing 

The  main  timing  reference  of  She  microcomputer  with  the  ex- 
ception of  the  FDC  circuit,  comes  from  a  20  2752  MHz  Crystal 
Oscillator  (Y1)  This  reference  is  divided  and  used  for  gener- 
ating all  necessary  timing  for  the  CPU.  video  circuit  and  RS- 
232-C  circuit  The  output  of  the  crystal  oscillator  is  filtered  by  a 
ferritte  bead  (FB5).  470  ohm  resistor  (R46)  and  a  68  pf  ca- 
pacitor {C242)  After  being  filtered  it  is  fed  into  U126  a  16R6A 
PAL  (Programmable  Array  Logic)  where  it  is  divided  by  2  to 
generate  a  1 0  1 376  MHz  signal  ( 1 0M)  for  the  64  X  1 6  video  dis- 
play U126  divides  the  20  2752  MHz  by  4  to  generate  a  5  0688 
MHz  signal  (RS232CLK)  for  the  baud  rate  generator  in  the  RS- 
232-C  circuit  The  CPU  clock  is  also  generated  by  U126  which 
can  be  either  2  or  4  MHz  depending  on  the  stale  of  FAST  input 


(pin  9  of  U126)  If  FAST  is  a  logic  low  the  20  2752  MHz  is  di- 
vided by  1 0  which  generates  a  2  2752  MHz  signal  If  FAST  is  a 
logic  high,  the  20  2752  MHz  is  divided  by  5  which  generates  a 
4  05504  MHz  signal  The  CPU  clock  (PCLK)  is  fed  through  an 
active  pull-up  circuit  which  generates  a  full  5-volt  swing  with  fast 
rise  and  fail  times  required  by  the  Z80A  U126  the  16R6A  Re- 
generates all  symmetrical  output  signals  and  also  does  not  al- 
low the  PCLK  output  to  short  cycle  or  generate  a  low  or  high 
pulse  under  110  nanoseconds  which  the  Z80A  also  requires 
Refer  to  System  Timing  Fig  3-2, 

3.1 .4.1  Video  Timing 

The  video  timing  is  controlled  by  a  10L8  PAL(U127}anda  four- 
bit  synchronous  counter  U128  (74LS161)  These  two  ICs  gen- 
erate all  the  necessary  timing  signals  for  the  four  video  modes; 
64  x  1 6.  32  x  1 6,  80  x  24.  and  40  x  24  Two  reference  clock  sig- 
nals are  required  for  the  four  video  modes  One  reference 
clock,  the  1 0  1 376  MHz  signal  (1 0M).  is  generated  by  U1 26  and 
is  used  by  the  64  x  16  and  32  x  16  modes  The  second  refer- 
ence clock  is  a  12  672  MHz  (12M)  signal  which  is  generated  by 
a  Phase  Locked  Loop  (PLL)  circuit  and  is  used  by  the  80  x  24 
and  40  x  24  modes  The  PLL  circuit  consists  of  U1 47  (74LS93). 
U148  {NE564  PLL).  and  U149  (74LS90)  The  original  20  2752 
MHz  clock  is  divided  by  16  through  U147  which  generates  a 
1  2672  MHz  signal  The  output  of  U147  is  reduced  in  amplitude 
by  the  voltage  divider  network  R27  and  R28  and  the  output  is 
coupled  to  the  reference  input  of  U148  by  C227 

The  PLL  (NE564)  is  adjusted  to  oscillate  at  12  672  MHz  by  the 
tuning  capacitor  C231  This  12  672  MHz  clock  is  then  divided 
by  10  through  U149  to  generate  a  second  1  2672  MHz  signal 
which  is  fed  to  a  second  input  of  U148  The  two  1  2672  MHz 
signals  are  compared  internally  to  the  PLL  where  it  corrects  the 
12  672  MHz  output  so  it  is  synchronized  with  the  20  2752  MHz 
clock 

MODSEL  and  8064*  signals  are  used  to  select  the  desired 
video  mode  8064*  controls  which  reference  clock  is  used  by 
U127  and  MODSEL  controls  the  single  or  double  character 
width  mode  Refer  to  the  following  chart  for  selecting  each 
video  mode 


8064* 

MODSEL 

Video  Mode 

0 

0 

64x16 

0 

1 

32x16 

1 
1 

0 
1 

80x24 
40x24 

*This  is  the  state  to  be  written  to  latch  U89  Signal  is  inverted 
before  being  input  to  U127 
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DCLK,  the  reference  cSock  selected,  is  output  from  U127 
DCLK  is  fed  back  into  U127  for  internal  timing  reference  and 
is  also  fed  to  the  clock  input  of  U128  (74LS161)  U128  is 
configured  to  preload  with  a  count  of  9  each  time  it  reaches 
a  count  of  0  This  generates  a  signai  output  of  TC  (128  pin 
15}  that  occurs  at  the  start  of  every  character  time  of  video 
output  TC  is  used  to  generate  LOADS"  (Load  Shift  Regis- 
ter) QA  and  QC  of  U128  are  used  to  generate  SHIFT*, 
XADR7*,  CRTCLK  and  LOAD"  for  proper  timing  for  the  four 
video  modes  QA,  QB,  and  QC  which  are  referred  to  as  H,  I, 
and  J  are  fed  to  the  Graphics  Port  J7  for  reference  timings 
of  Hires  graphics  video,  Refer  to  Video  Timing,  Figs  3-3  and 
3-4  for  timing  reference. 
3.1.5  Address  Decode 

The  Address  Decode  section  will  be  divided  into  two  sub- 
sections: Memory  Map  decoding  and  Port  Map  decoding, 

3.1.5.1  Memory  Map  Decoding 

Memory  Map  Decoding  is  accomplished  by  a  1 6L8  PAL  (U 1 09) 
Four  memory  map  modes  are  available  which  are  compatible 


witt!  tntr  iviuuui  in  c 


PAL  (U1 10)  is  used  in  conjunction  with  U109  for  the  memory 
map  control  which  also  controls  page  mapping  of  the  32K  RAM 
pages  Refer  to  Memory  Maps  below 

3.1.5.2  Port  Map  Decoding 

Port  Map  Decoding  is  accomplished  by  three  74LS138S  (U87, 
U88,  and  U107)  These  ICs  decode  the  low  order  address  (A0- 
A7}  from  the  CPU  and  decode  the  port  being  selected  The  IN" 
signal  from  U108  enables  U87  which  allows  the  CPU  to  read 
from  a  selected  port  and  the  OUT*  signal,  also  from  U108.  en- 
ables U88  which  ailows  the  CPU  to  write  to  the  selected  port 
U107  only  decodes  the  address  and  the  IN*  and  OUT*  signals 
are  ANDed  with  the  generated  signals 

3.16  ROM 

The  Model  4P  contains  only  a  4K  x  8  Boot  ROM  (U70)  This 
ROM  is  used  only  to  boot  up  a  Disk  Operating  System  into 
the  RAM  memory  If  Model  ME  operation  or  DOS  is  required, 
then  the  RAM  from  location  0000-37FFH  must  be  loaded  with 
an  image  of  the  Model  ill  or  4  ROM  code  and  then  executed 
A  file  called  MODEL  A/Ill  is  supplied  with  the  Model  4P  which 
contains  the  ROM  image  for  proper  Model  ill  operation  On 
power-up,  the  Boot  ROM  is  selected  and  mapped  into  loca- 
tion 0OO0-0FFFK  After  the  Boot  Sector  or  the  ROM  Image  is 
loaded,  the  Boot  ROM  must  be  mapped  out  by  OUTing  to 
port  9CH  with  DO  set  or  by  selecting  Memory  Map  modes  2 
or  3.  in  Mode  1  the  RAM  is  write  enabled  for  the  full  14K 
This  allows  the  RAM  area  mapped  where  Boot  ROM  is  lo- 
cated to  be  written  to  while  executing  out  of  the  Boot  ROM 
Refer  to  Memory  Maps. 


The  Model  4P  Boot  ROM  contains  all  the  code  necessary  to 
initialize  hardware  detect  options  selected  from  the  keyboard 
read  a  sector  from  a  hard  disk  or  floppy  and  load  a  copy  of  the 
Model  III  ROM  Image  (as  mentioned)  into  the  lower  14K  oi 
RAM 

The  firmware  is  divided  into  the  following  routines: 

*  Hardware  Initialization 
'    Keyboard  Scanner 

'  Control 

'  Floppy  and  Hard  Disk  Driver 

"  Disk  Directory  Searcher 

'  File  Loader 

'  Error  Handler  and  Displayer 

*  RS-232Boot 

"    Diagnostic  Package 

Theory  of  Operation 

This  section  describes  the  operation  of  various  routines  in  the 
ROM  Normally  the  ROM  is  not  addressable  by  norma!  use 
However  there  are  several  routines  that  are  available  through 
fixed  calling  locations  and  these  may  be  used  by  operating  sys- 
tems that  are  booting 

On  a  power-up  or  RESET  condition  the  Z80  s  program  counter 
is  set  to  address  0  and  the  boot  ROM  is  switched-in  The  mem- 
ory map  of  the  system  is  set  to  Mode  0  (See  Memory  Map  for 
details )  This  will  cause  the  Z80  to  fetch  instructions  from  the 
boot  ROM 

The  initialization  section  of  the  Boot  ROM  now  performs  these 
functions: 


Disables  maskable  and  non-maskable  interrupts 

Interrupt  mode  1  is  selected 

Programs  the  CRT  Controller 

Initializes  the  boot  ROM  control  areas  in  RAM 

Sets  up  a  stack  pointer 

Issues  a  Force  Interrupt  to  the  Floppy  Disk  Controller 

to  abort  any  current  activity 

Sets  the  system  clock  to  4mhz 

Sets  the  screen  to  64  x  1 6 

Disables  reverse  video  and  the  alternate  character 

sets 

Tests  for  <    >  key  being  pressed' 

Clears  all  2K  of  video  memory 


*  This  is  a  special  test  if  the  <  ■  is  being  pressed,  then 
control  is  transferred  to  the  diagnostic  package  in  the 
ROM  All  other  keys  are  scanned  via  She  Keyboard 
Scanner 
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The  Keyboard  scanner  is  now  called  It  scans  the  keyboard  for 
a  set  period  of  time  and  returns  several  parameters  based  on 
which,  if  any,  keys  were  pressed 

The  keyboard  scanner  checks  for  several  different  groups  of 
keys  These  are  shown  below: 


Function  Group 

<F1> 

selection  Group 

A 

<F2> 

B 

<F3> 

C 

<  1  > 

D 

<2> 

E 

<3> 

F 

<Left-Shift> 

G 

<Right-Shifl> 
<Ctrl> 

<Caps> 

Special  Keys 

<p> 

Misc  Keys 

<Enler  ■■■ 

<L> 

■  Break  - 

■de- 

When any  key  in  the  Function  Group  is  pressed,  it  is  recorded 
in  RAM  and  will  be  used  by  lhe  Control  routine  in  directing  the 
action  of  the  boot  If  more  than  one  of  these  keys  are  pressed 
during  the  keyboard  scan,  the  fast  one  detected  will  be  the  one 
that  is  used  The  Function  group  keys  are  currently  defined  as: 


<F1>or<1> 
<F2>or<2> 
<F3>or<3:^ 

<  Left-Shift  > 

<  Right-Shift  > 
<Ctrl> 
<Caps> 


Will  cause  hard  disk  boot 
Will  cause  floppy  disk  boot 
Will  force  Model  HI  mode 
Reserved  for  future  use 
Boot  from  RS-232  port 
Reserved  for  future  use 
Reserved  for  future  use 


<L Instructs  the  Control  routine  to 

load  the  Model  l!i  ROM  image 
even  if  it  is  already  loaded  This 
is  useful  if  the  ROM  image  has 
been  corrupted  or  when  switch- 
ing ROM  images  (Note  that 
this  will  not  cause  the  ROM- 
image  to  be  loaded  if  the  boot 
sector  check  indicates  that  the 
Model  Ml  ROM  image  is  not 
needed  Press  ■  F3  -or  F3 
and  ■  L  >  to  accomplish  that 

The  Selection  group  keys  are  used  in  determining  which  file  will 
be  read  from  disk  when  the  ROM  image  is  loaded  For  details 
ot  this  operation,  see  the  Disk  Directory  Searcher  if  more  than 
one  of  the  Selection  group  keys  are  pressed  the  last  one  de- 
tected will  be  the  one  that  is  used 


The  Miscellaneous  keys  are: 


Pressing  this  key  is  simply  re- 
corded by  setting  location 
405BH  non-zero  It  is  up  to  an 
operating  system  to  use  this 
flag  if  desired 

Terminates  the  Keyboard  rou- 
tine Any  other  keys  pressed  up 
to  that  time  will  be  acted  upon 
•  Enter  •  is  useful  for  experi- 
enced users  who  do  not  want  to 
watt  untii  the  keyboard  timer 
expires 


The  Control  section  now  takes  over  and  follows  the  following 
flowchart 


The  Special  keys  are  commands  to  the  Control  routine  which 
direct  handling  of  the  Model  III  ROM-image  Each  key  is  de- 
tected individually 

<P>  When  loading  the  Model  III 

ROM  image,  the  user  will  be 
prompted  when  the  disks  can 
be  switched  or  when  ROM 
BASIC  can  be  entered  by 
pressing     Break  ■ 

<N>  Instructs  the  Control  routine  to 

not  load  the  Model  111  ROM 
image,  even  if  it  appears  that 
the  operating  system  being 
booted  requires  it 
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®L.OtO  I 
(Hard  Disk 


Goto  lil 

Boot ) 


Goto  12] 
(floppy  Disk  Boot) 


,      Goto  (3| 
6)     (Model  III  Boot) 


d> 


/T\         Goto    [4) 
\^J     (RS-232    Boot) 


At  this  point,  no  valid  Function  keys 
have  been  pressed. 


Display  an  error 
message,.  ( ARCNET 
Boot  ROM  required 
for  ARCNET-  Boot  ) 


® 


-> 


V 


Attempt  to 
read  boot 
sector 


Display 

Hard  Disk 

Error 

Message 


Attempt  to 
read  boot 
sector 


<- 


®  © 


(  Stop  \ 
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® 


© 


Display 
Floppy  Disk 
Error 
Message 


f       Stop       J 


Set  Transfer 
Address  to 
4  30J0H 
Note:  2 


Attempt  to 

locate 

ROM  Image 

on 

Floppy  Disk 

Note:  4 


Write-enable 
0-37FFH 
(Mode  11 


JL 


A , 


Set 

Transfer 
Address  ■ 
3015H 
Note:  2 


-> 


Set  Transfer 
Address  at  end 
of  ROM  Image 
(Normally  3015H) 
Note:  2 


Display 

Error 

Message 


3z: 


<- 


<D 


-> 


(   stop  ~) 
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Wait  for 
< ENTERS  or 
<BREAK>  to 
be  pressed 


-> 


Write-protect 
memory  (Mode  0 ) 


^L 


Set  CPU    speed 
to   2MHZ 


^ 


G\- 


1 


Switch  boot   HQM 
out   of    Memory 

Jump    to 
Transfer   Address 

-^t 


Initialize 
RS-232  Port 
Note:  6 


Determine 
Correct 
Baud  Rate 


Transmit  Saud 
Rate  Oetect 
Message 


6 
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CD 


for 
Byte 


Load  program 
from  R5-232 


Display  and 
transmit  error 


-XD 


Transfer 

CO 

itrol 

to 

addre. 
reived 

s 

Packages  (hat  do  no!  reference  the  Model  ill  ROM  in  the 
bool  sector  can  still  cause  the  Model  ill  ROM  image  to  be 
loaded  by  coding  a  CDxxOO  somewhere  in  Ihe  boot  sector 
It  does  not  have  to  be  executable  At  the  same  time,  Model 
4  packages  must  take  care  that  there  is  no  sequence  of 
bytes  in  the  boot  sector  that  could  be  mis-interpreted  to  be 
a  reference  to  the  Boot  ROM  An  example  of  this  would  be 
sequence  06CD0E00.  which  is  a  LD  B.OCDH  and  a  LD 
CO  If  the  boot  sector  cannot  be  changed,  then  the  user 
must  press  the  <F3>  key  each  time  the  system  is  started 
to  inform  the  ROM  that  the  disk  contains  a  Model  ill  pack- 
age which  needs  the  Model  Ml  ROM  image 

(2)  If  you  are  loading  a  Model  4  operating  system,  then  the 
boot  ROM  will  always  transfer  control  to  the  first  byte  of  the 
boot  sector,  which  is  at  4300H  If  you  are  loading  a  Model 
III  operating  system  or  about  to  use  Model  III  ROM  BASIC, 
then  the  transfer  address  is  301 5H  This  is  the  address  of 
a  jump  vector  in  the  "C"  ROM  of  the  Model  Hi  ROM  image, 
and  this  will  cause  the  system  to  behave  exactly  like  a 
Mode!  lit  if  the  ROM  image  file  that  is  loaded  has  a  differ- 
ent transfer  address,  then  that  address  will  be  used  when 
loading  is  complete.  If  the  image  is  already  present,  the 
Boot  ROM  will  use  301 5H 

(3)  Two  different  tests  are  done  to  insure  that  the  Model  III 
ROM  image  is  present  The  first  test  is  to  check  every  third 
location  starting  at  3000H  for  a  C3H  This  is  done  for  1 0  lo- 
cations If  any  of  these  locations  does  not  contain  a  C3H, 
then  the  ROM  image  is  considered  to  be  not  present' 
The  next  test  is  to  check  two  bytes  at  location  OOOBH  If 
these  addresses  contain  E9E1H,  then  me  ROM  image  is 
considered  to  be   present" 


(4)    See  Disk  Director  Searcher  for  more  information 


If  the  boot  sector  was  not  256  bytes  in  length,  then  it  is  as- 
sumed to  be  a  Model  III  package,  and  (he  ROM  image  will 
be  needed  If  the  sector  is  256  bytes  in  length,  then  the 
sector  is  scanned  for  the  sequence  CDxxOOH  The  CD  is 
Ihe  first  byte  of  a  Z80  unconditional  subroutine  call  The 
next  byte  can  have  any  value  The  third  byte  is  tested 
against  a  zero  What  this  check  does  is  test  for  any  refer- 
ences to  the  first  256  bytes  of  memory  All  Radio  Shack 
Model  III  operating  systems,  and  many  other  packages  all 
reference  the  ROM  at  some  point  during  the  boot  sector 
Most  boot  sectors  will  display  a  message  if  the  system  can- 
not be  loaded  To  save  space,  these  routines  use  the 
Model  III  ROM  calls  to  display  the  message  Several  ROM 
calls  have  their  entry  points  in  the  first  256  bytes  of  mem- 
ory, and  these  references  are  detected  by  the  bool  ROM 


(5)    See  File  Loader  for  more  information 

(6}   The  RS-232  loader  is  described  under  RS-232  Boot 

Disk  Directory  Searcher 

When  the  Model  III  ROM  image  is  to  be  loaded,  it  is  always  read 
from  the  floppy  in  drive  0 

Before  the  operation  begins,  some  checks  are  made  First,  the 
boot  sector  is  read  in  from  the  floppy  and  the  first  byte  is 
checked  to  make  sure  it  is  either  a  00H  or  a  FEH  If  the  byte 
contains  some  other  value,  no  attempt  will  be  made  to  read  the 
ROM  image  from  that  disk  The  location  of  the  directory  cylinder 
is  then  taken  from  the  boot  sector  and  the  type  of  disk  is  deter- 
mined This  is  done  by  examining  the  Data  Address  Mark  that 
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was  picked  up  by  the  Floppy  Disk  Controller  (FDC)  during  the 
read  of  the  sector  il  (he  DAM  equals  1 ,  the  disk  is  a  TRSDOS 
1  x  style  disk  If  the  DAM  equals  0,  then  the  disk  is  a  LDOS  5  1/ 
TRSDOS  6  style  disk  This  is  important  since  TRSDOS  1  x 
disks  number  sectors  starting  with  1  and  LDOS  style  disks 
number  sectors  starting  with  0 

Once  the  disk  type  has  been  determined,  an  extra  test  is  made 
if  the  disk  is  a  LDOS  style  disk  This  test  reads  the  Granule  Al- 
location Table  (GAT)  to  determine  if  the  disk  is  single  sided  or 
double  sided 


Floppy  and  Hard  Disk  Driver 

The  disk  drivers  are  entered  via  RST  SH  and  will  read  a  sector 
anywhere  on  a  floppy  disk  and  anywhere  on  head  1  (top-head) 
in  a  hard  disk  drive  Either  256  or  512  byte  sectors  are  readable 
by  these  routines  and  they  make  the  determination  of  the  sector 
size  The  hard  disk  driver  is  compatible  with  both  the  WD1000 
and  the  WD1 01 0  controllers  The  floppy  disk  driver  is  written  for 
She  WD1793  controller 

Serial  Loader 


The  directory  is  then  read  one  record  at  a  time  and  a  compare 
is  made  against  the  pattern  MODEL%  '  for  the  filename  and 
■III'  for  the  extension  The  %'  means  that  any  character  will 
match  this  position  If  the  user  pressed  one  of  the  selection 
keys  (A-G)  during  the  keyboard  scan,  then  that  character  is 
substituted  in  place  of  the  '%'  character  For  example,  if  you 
pressed  'D\  then  the  search  would  be  for  the  file  'MODELD  \ 
with  the  extension  III'  The  searching  algorithm  searches  until 
it  finds  the  entry  or  it  reaches  the  end  of  the  directory 

Once  the  entry  has  been  found,  the  extent  information  for  that 
file  is  copied  into  a  control  block  for  later  use 

Fife  Loader 

The  file  loader  is  actually  two  modules  —  the  actual  loader  and 
a  set  of  routines  to  fetch  bytes  from  the  file  on  disk  The  loader 
is  invoked  via  a  RST  28H  The  byte  fetcher  is  called  by  the 
loader  using  RST  20H  Since  restart  vectors  can  be  re-directed, 
the  same  loader  is  used  by  the  RS-232  boot  The  difference  is 
that  the  RST  20H  is  redirected  to  point  to  the  RS-232  data  re- 
ceiving routine  The  loader  reads  standard  loader  records  and 
acts  upon  two  types: 

01  Data  Load 

1  byte  with  length  of  block,  including  address 

1  word  with  address  to  load  the  data 

n  bytes  of  data,  where  n  +  2  equals  the  length  specified 

02  Transfer  Address 

1  byte  with  the  value  of  02 

1  word  with  the  address  to  start  execution  at 

Any  other  loader  code  is  treated  as  a  comment  block  and  is  ig- 
nored. Once  an  02  record  has  been  found,  the  loader  stops 
reading,  even  if  there  is  additional  data,  so  be  sure  to  place  the 
02  record  at  the  end  of  the  file 


Invoking  the  serial  loader  is  similar  to  forcing  a  boot  from  hard 
disk  or  floppy  In  this  case  the  right  shift  key  must  be  pressed  at 
some  time  during  the  first  three  seconds  after  reset  The  pro- 
gram does  not  care  if  the  key  is  pressed  forever,  making  it  con- 
venient to  connect  pins  8  and  1 0  of  the  keyboard  connector  with 
a  shorting  plug  for  bench  testing  of  boards  This  assumes  that 
the  object  program  being  loaded  does  not  care  about  the  key 
closure 

Upon  entry,  the  program  first  asserts  DTR  (J4  pin  20)  and  RTS 
{J4  pin  4)  true  Next,  "Not  Ready  is  printed  on  the  topmost  line 
of  the  video  display  Modem  status  line  CD  (J4  pin  8)  is  then 
sampled  The  program  loops  until  it  finds  CD  asserted  true  At 
that  time  the  message  "Ready  is  displayed  Then  the  program 
sets  about  determining  the  baud  rate  from  the  host  computer 

To  determine  the  baud  rate,  the  program  compares  data  re- 
ceived by  the  UART  to  a  test  byte  equal  to  '55  hex  The  receiver 
is  first  set  to  1 9200  baud  If  ten  bytes  are  received  which  are  not 
equal  to  the  test  byte,  the  baud  rate  is  reduced  This  sequence 
is  repeated  until  a  valid  test  byte  is  received  If  ten  failures  occur 
at  50  baud,  the  entire  process  begins  again  at  1 9200  baud  If  a 
valid  test  byte  is  received,  the  program  waits  for  ten  more  to  ar- 
rive before  concluding  that  it  has  determined  the  correct  baud 
rate  If  at  this  time  an  improper  byte  is  received  or  a  receiver  er- 
ror (overrun,  framing,  or  parity)  is  intercepted,  the  task  begins 
again  at  19200  baud 

In  order  to  get  to  this  point,  the  host  or  the  modem  must  assert 
CD  true  The  host  must  transmit  a  sequence  of  test  bytes  equal 
to  '55'  hex  with  8  data  bits,  odd  parity,  and  1  or  2  stop  bits  The 
test  bytes  should  be  separated  by  approximately  0  1  second  to 
avoid  overrun  errors. 

When  the  program  has  determined  the  baud  rate,  the  message: 

"Found  Baud  Rate  x v 


is  displayed  on  the  screen,  where  "x'  is  a  letter  from  A  to  P. 
meaning: 


A  -  50  baud  E  =  150  I  = 

B  -  75  F  =  300  J 

C  =  110  G  -  600  K 

D  =  134  5  H  -  1200  L 


1800  M  -  4800 

=  2000  N  -  7200 

=  2400  O  =  9600 

=  3600  P  =  19200 
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The  same  message  less  the  character  signifying  the  baud  rale 
is  transmitted  to  the  host,  with  the  same  baud  rate  and  protocol 
This  message  is  the  signal  to  the  host  to  stop  transmitting  test 
bytes 

After  the  program  has  transmitted  the  baud  rate  message,  it 
reads  from  the  UART  data  register  in  order  to  clear  any  overrun 
error  that  may  have  occurred  due  to  the  test  bytes  coming  in 
during  the  transmission  of  the  message  This  is  because  the  re- 
ceiver must  be  made  ready  to  receive  a  sync  byte  signalling  the 
beginning  of  the  command  file  For  this  reason,  it  is  important 
that  the  host  wait  until  the  entire  baud  rate  message  {16  char- 
acters) is  received  before  transmitting  the  sync  byte,  which  is 
equai  toTF'hex 

When  the  loader  receives  the  sync  byte,  the  message: 

"Loading" 

is  displayed  on  the  screen  Again,  the  same  message  is  trans- 
mitted  to  the  host,  and,  again,  the  host  must  wait  for  the  entire 
transmission  before  starting  into  the  command  file 

If  the  receiver  should  intercept  a  receive  error  while  waiting  for 
the  sync  byte,  the  entire  operation  up  to  this  point  is  aborted 
The  video  display  is  cleared  and  the  message: 

"Error,  x" 

is  displayed  near  the  bottom  of  the  screen,  where  "x"  is  a  letter 
from  B  to  H,  meaning: 

B  =  parity  error 

C  =  framing  error 

D  =  parity  &  framing  errors 

E  =  overrun  error 

F  =  parity  &  overrun  errors 

G  =  framing  &  overrun  errors 

H  =  parity  &  framing  &  overrun  errors 

The  message: 


{Since  the  file  represents  280  machine  code  and  all  256 
combinations  are  meaningful,  it  would  be  disastrous  to 
transmit  nuils  or  other  ASCII  control  codes  as  fillers,  ac- 
knowledgement, or  start-stop  bytes  The  only  control 
codes  needed  are  the  standard  command  file  control 
bytes  ) 

Data  can  be  transmitted  to  the  loader  at  1 9200  baud  with  no  de- 
lays inserted  Two  stop  bits  are  recommended  at  high  baud 
rates 

See  the  File  Loader  description  for  more  information  on  file 
loading 

If  a  receive  error  should  occur  during  file  loading,  the  abort  pro- 
cedure described  above  will  take  place,  so  when  attempting  re- 
mote control,  it  is  wise  to  monitor  the  host  receiver  during 
transmission  of  the  file  When  the  host  is  near  the  object  board- 
as  is  the  case  in  the  factory  application,  or  when  more  than  one 
board  is  being  loaded,  it  may  be  advantageous  or  even  nec- 
essary to  ignore  the  transmitted  responses  of  the  object 
board(s)  and  to  manually  pace  the  test  byte,  sync  byte,  and 
command  file  phases  of  the  transmission  process,  using  the 
video  display  for  handshaking 

System  Programmers  Information 

The  Model  4P  Boot  ROM  uses  two  areas  of  RAM  while  it  is  run- 
ning These  are  4000H  to  40FFH  and  4300H  to  43FFH  (For 
512  byte  boot  sectors,  the  second  area  is  4300H  to  44FFH  }  If 
the  Model  III  ROM  Image  is  loaded,  additional  areas  are  used 
See  the  technical  reference  manual  for  the  system  you  are  us- 
ing for  a  list  of  these  areas 

Operating  systems  that  want  to  support  a  software  restart  by  re- 
executing  the  contents  of  the  boot  ROM  can  accomplish  this  in 
one  of  two  ways  If  the  operating  system  relies  on  the  Model  ill 
ROM  Image,  then  jump  to  location  0  as  you  have  in  the  past  If 
the  operating  system  is  a  Model  4  mode  package,  a  simple  way 
is  to  code  the  following  instructions  in  your  assembly  and  load 
them  before  you  want  to  reset: 


"Error" 

is  then  transmitted  to  the  host  The  entire  process  is  then  re- 
peated from  the  "Not  Ready"  message  A  six  second  delay  is 
inserted  before  reinitialization  This  is  longer  than  the  time  re- 
quired to  transmit  five  bytes  at  50  baud,  so  there  is  no  need  to 
be  extra  careful  here 

If  the  sync  byte  is  received  without  error,  then  the  Loading" 
message  is  transmitted  and  the  program  is  ready  to  receive  the 
command  file  After  receiving  the  "Loading"  message  the  host 
can  transmit  the  file  without  nulls  or  delays  between  bytes 


Absolute  Location 

0000 
0001 
0003 


instruction 

Dl 

LD  A.1 

OUT  {9CH).A 


These  instructions  cause  the  boot  ROM  to  become  address- 
able After  executing  the  OUT  instruction,  the  next  instruction 
executed  will  be  one  in  the  boot  ROM  (These  instructions  also 
exist  in  the  Model  ill  ROM  image  at  location  0  }  The  boot  ROM 
has  been  written  so  that  the  first  instruction  is  at  address  0005 
The  hardware  must  be  in  memory  mode  0  or  1,  or  else  the 
boot  ROM  will  not  be  switched  in  This  operation  can  be 
done  with  an  OUT  instruction  and  then  a  RST  0  can  be  exe- 
cuted to  have  the  ROM  switched  in. 
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Restarts  can  be  redirected  at  any  time  while  the  ROM  is 
switched  in  All  restarts  jump  to  fixed  locations  in  RAM  and 
these  areas  may  be  changed  to  point  to  the  routine  that  is  to  be 
executed 

Restart    RAM  Location     Default  Use 

Cold  Start/Boot 

Disk  I/O  Request 

Display  string 

Display  block 

Byte  Fetch  (Called  by  Loader) 

File  Loader 

Keyboard  scanner 

Reserved  for  future  use 

NMI  (Floppy  I/O  Command 

Complete) 


Display  String  (RST1  OH) 


0 

none 

8 

4000H 

10 

4003H 

18 

4006H 

20 

4009H 

28 

400CH 

30 

400FH 

38 

4012H 

66 

401 5H 

Accepts 
HL 


Returns 
Success  Always 

A 

DE 

HL 


Pointer  to  text  to  be  displayed 
Text  must  be  terminated  with  a  null  (0) 
Offset  position  on  screen  where  text  is  to 
be  displayed 

(A  O00OH  will  be  the  upper  left-hand  cor- 
ner of  the  display  ) 


Altered 

Points  to  next  position  on  video 

Points  to  the  null  (0) 


Display  Block  (RST18H) 


The  above  routines  have  fixed  entry  parameters  These  are  de- 
scribed here 

Htclr  (/O  Penult  /RST  8H) 

Accepts 


Accepts 
HL 


Points  to  control  vector  in  the  format: 


A 

1  for  floppy 

2  for  hard  disk 

B 

Command 
Initialize 

1 

Restore 

4 

Seek 

6 

Read 

12  (All  reads 

DE 
HL 


Returns 
Z 
NZ 

Error  Codes 
3 
4 
5 


8 
9 
11 
12 


plied  seek) 
Sector  number  to  read 
The  contents  of  the  location  disktype 
(405CH)  are  added  to  this  value  before 
an  actual  read  If  the  disk  is  a  two  sided 
floppy,  just  add  18  to  the  sector  number 
Cylinder  number    (Only  E  is  used  in 
floppy  operations) 

Address  where  data  from  a  read  opera- 
tion is  to  be  stored 


Success,  Operation  Completed 
Error.  Error  code  in  A 


Hard  Disk  drive  is  no!  ready 

Floppy  disk  drive  is  not  ready 

Hard  Disk  drive  is  not  available 

Floppy  disk  drive  is  not  available 

Drive  Not  Ready  and  no  Index  (Disk  in 

drive,  door  open) 

CRC  Error 

Seek  Error 

Los!  Data 

ID  Not  Found 


+  0 
+  2 
null 
+  4 
null 


Screen  Offset 

Pointer  to  text,  terminated  with 


Pointer  to  text,  terminated  with 


+  n        word  FFFFH        End  of  control 
vector 
or  +n        word  FFFEH        Next  word  is 

new  Screen 
Offset 
If  Z  flag  is  set  on  entry,  then  the  first  screen  offset  is  read  from 
DE  instead  of  from  the  control  vector 

Each  string  is  positioned  after  the  previous  string,  unless  a 
FFFEH  entry  is  found  This  is  used  heavily  in  the  ROM  to  re- 
duce duplication  of  words  in  error  messages 

Returns 
Success  Always 

DE  Points  to  next  position  on  video 

Byte  Fetch  (RST  20H) 


Accepts  None 
Returns 

Z 

NZ 

Errors 


2 

10 


Success,  byte  in  A 
Failure,  error  code  in  A 


Any  errors  from  the  disk  I/O  call  and: 

ROM  Image  can't  be  loaded  —■  Too  many 

extents 

ROM  Image  can  t  be  loaded  —  Disk  drive 

is  not  ready 
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File  Loader  (RST28H) 

Accepts  None 


Returns 
2 
NZ 

Errors 


Success 

Failure,  error  code  in  A 


Any  errors  from  the  disk  I/O  call  or  the 
byte  (etch  call  and: 
0  The  ROM  image  was  not  found  on  drive  0 

There  are  several  pieces  of  information  left  in  memory  by  the 
boot  ROM  which  are  useful  to  system  programmers  These  are 
shown  below: 


RAM  Location 

401 DH 


4056H 
4057H 


Description 

ROM  Image  Selected  (%  for  none 
selected  or  A-G) 
Boot  type 

1  =  Floppy 

2  =  Hard  disk 

3  -  ARCNET 

4  -  RS-232C 
5*7=  Reserved 

Boo!  Sector  Size  (1  for  256.  2  for  512) 

RS-232  Baud  Rate  (only  valid  on  RS- 

232  boot) 

Function  Key  Selected 

0  -  No  function  key  selected 


<F1>or<1> 

86 

<F2>  or  <2> 

87 

<F3>  or  <3> 

88 

<Caps> 

85 

<Ctrl> 

84 

<Left-Shift> 

82 

<  Right-Shift  > 

83 

Reserved 

80-81  and  89-90 

Break  Key  Indication  {non-zero  if 

< Break >  pressed) 

Disk  type 

(0  (or  LDOS' 

TRSDOS6.1  for 

TRSDOS  1  x) 

Keep  in  mind  that  Model  II!  ROM  image  will  initialize  these 
areas,  so  this  information  is  useful  only  to  the  Model  4  mode 
programmer 

3.1.7  RAM 

Two  configurations  of  Random  Access  Memory  (RAM)  are 
available  on  the  Mode!  4P:  64K  and  128K  The  64K  and  128K 
option  use  the  6665-type  64K  x  1  200NS  Dynamic  RAM,  which 
requires  only  a  single  +  5v  supply  voltage 


The  DRAMs  require  multiplexed  incoming  address  lines  This 
is  accomplished  by  ICs  U111  and  U112  which  are  74LS157 
multiplexers  Data  to  and  from  the  DRAMs  are  buffered  by  a 
74LS245(U1 17)  which  is  controlled  by  Page  Map  PAL,  U110 
The  proper  timing  signals  RAS0\  RAS1 '.  MUX*,  and  CAS*  are 
generated  by  a  delay  line  circuit  U97  U115  (1/2  of  a  74S112) 
and  U1 16  (1/4  of  a  74F08)  are  used  the  generate  a  precharge 
circuit  During  M1  cycles  of  the  Z80A  in  4  MHz  mode,  the  high 
time  in  MREQ  has  a  minimum  time  of  11 0  nanosecs  The  spec- 
ification of  6665  DRAM  requires  a  minimum  of  1 20  nanosecs  so 
this  circuit  will  shorten  the  MREQ  signal  during  the  M1  cycle 
The  resulting  signal  PMREQ  is  used  to  start  a  RAM  memory 
cycle  through  U1 13  (a  74S64)  Each  different  cycle  is  controlled 
at  U1 13  to  maintain  a  fast  M1  cycle  so  no  wait  states  are  re- 
quired The  output  of  U113  (PRAS*)  is  ANDed  with  RFSH  to  not 
allow  MUX*  and  CAS*  to  be  generated  during  a  REFRESH 
cycle  PRAS*  also  generates  either  RAS0*  or  RAS1*.  depend- 
ing on  which  bank  of  RAM  the  CPU  is  selecting  GCAS*  gen- 
erated by  the  delay  line  U97  is  latched  by  U1 15  (1/2  of  a 
74S112)  and  held  to  the  end  of  the  memory  cycle  The  output 
of  U11 5  is  ANDed  with  VIDEO  signal  to  disable  the  CAS*  signal 
from  occurring  if  the  cycle  is  a  video  memory  access  Refer  to 
M1  Cycle  Timing  (Figure  3-8.  and  3-9),  Memory  Read  and 
Memory  Write  Cycle  Timing  (Figure  3-10)  and  (Figure  3- 
11.). 
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Memory  Map  —  Model  4P 


ModeO 

SELC 
SEL1 
ROM 

=  0  -  ov 
=  0  -  ov 
^  1   ^  ov 

Mode  1 

SELO    -  1    -  +5V 
SEL1    «  0    =  OV 
ROM    -  0    -   +  5V 

0000  —  OFFF 

Boot  ROM 

4K 

0000  —  37FF 

RAM 

14K 

1000  —  37FF 

RAM  (Read  Only) 

10K 

3800  — 3BFF 

Keyboard 

1K 

37E8  —  37E9 

Printer  Status  (Read  Only) 

2 

3C00  —  3FFF 

Video 

1K 

3800  —  3BFF 

Keyboard 

1K 

4000  —  FFFF 

RAM 

48K 

3C00  — 3FFF 

Video 

1K 

4000  —FFFF 

RAM 

48K 

Mode  2 

SELO    -  0    -  OV 
SEL1    -  1    -   +5V 

ModeO 

SELO 
SEL1 

-  0  =  ov 
=  0  -  ov 

ROM    =  X  -  Don!  Care 

ROM 

=  0    *   +  5V 

0000— F3FF 
F400  — F7FF 

RAM 
Keyboard 

61K 
1K 

0000  —  37FF 

RAM  (Read  Only) 

14K 

F800  —  FFFF 

Video 

2K 

37E8  — 37E9 

Printer  Status  (Read  Only) 

2 

3800  —  3BFF 

Keyboard 

1K 

3C00  — 3FFF 

Video 

1K 

Mode  3 

SELO    =1    -  +5V 

4000— FFFF 

RAM 

48K 

SEL1    =1    =  +5V 
ROM    -  X  -  Don't  Care 

Mode  1 

SELO 
SEL1 
ROM 

=  1    =  +5V 
-  0  -  ov 

=  1   =  ov 

0000  —  FFFF 

RAM 

64  K 

0000  — OFFF 

Boot  ROM 

4K 

0000™  OFFF 

RAM  (Write  Only) 

4K 

1000  — 37FF 

RAM 

10K 

3800  — 3BFF 

Keyboard 

1K 

3C00  —  3FFF 

Video 

1K 

4000  —  FFFF 

RAM 

48K 
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I/O  Port  Assignment 


Port# 

Normal 
Used 

y 

Out 

In 

FC- 

™FF 

FF 

CASSOUT  * 

MODIN* 

F8- 

-FB 

F8 

LPOUT  * 

LPIN* 

F4~ 

-F7 

F4 

DRVSEL ' 

(RESERVED) 

F0~ 

~F3 

_ 

DISKOUT  * 

DSSKIN  * 

FO 

FO 

FDC  COMMAND  REG 

FDC  STATUS  REG 

F1 

F1 

FDC  TRACK  REG 

FDC  TRACK  REG 

F2 

F2 

FDC  SECTOR  REG 

FDC  SECTOR  REG 

F3 

F3 

FDC  DATA  REG 

FDC  DATA  REG 

EC- 

-EF 

EC 

MODOUT  * 

RTCIN  * 

E8- 

-EB 

_ 

RS2320UT  * 

RS2321N  * 

E8 

E8 

UART  MASTER  RESET 

MODEM  STATUS 

E9 

E9 

BAUD  RATE  GEN  REG 

(RESERVED) 

EA 

EA 

UART  CONTROL  AND 
MODEM  CONTROL  REG 

UART  STATUS  REG 

EB 

EB 

UART  TRANSMIT 
HOLDING  REG 

UART  HOLDING  REG 
(RESETDR) 

E4- 

-E7 

E4 

WRNMI  MASK  REG  * 

RD  NMI  STATUS  ' 

EO 

.......  pt 

EO 

WP  !MT  MASK  SFO    * 

RH  INT  MARK  RFG    ' 

A0- 

~~DF 

_ 

(RESERVED) 

(RESERVED) 

9C 

~9F 

9C 

BOOT* 

(RESERVED) 

94- 

-9B 

_ 

(RESERVED) 

(RESERVED) 

90- 

-93 

90 

SEN" 

(RESERVED) 

8C 

-8F 

_ 

GSELO  * 

GSELO  * 

88- 

-8B 

_ 

CRTCCS  * 

(RESERVED) 

88,  8A 

88 

CRCTADD  REG 

(RESERVED) 

89. 

8B 

89 

CRCT  DATA  REG 

(RESERVED) 

84- 

™87 

84 

OPREG  * 

(RESERVED) 

80- 

-83 

_ 

GSEL1  * 

GSEL1 ' 
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I/O  Port  Description 

Name:  CASSOUT  * 

Port  Address:  FC  —  FF 
Access:  WRITE  ONLY 

Description:      Output  data  to  cassette  or  for  sound 
generation 

Note:      The  Mode!  4P  does  not  support  cassette  storage, 
this  port  is  oniy  used  to  generate  sound  that  was  to 
be  output  via  cassette  port  The  Model  4P  sends 
data  to  onboard  sound  circuit 

DO  =  Cassette  output  level  (sound  data  output) 

D1  =  Reserved 

D2  —  D7      =  Undefined 


Name:  LPIN  * 

Port  Address:  F8  —  FB 

Access:  READONLY 

Description:  Input  line  printer  status 

DO— D3   -  (RESERVED) 

D4       -  FAULT 

1  =  TRUE 

0  =  FALSE 

D5       =  UNIT  SELECT 

1  =  TRUE 

0  -  FALSE 

D6       =  OUTPAPER 

1  =  TRUE 
0  =  FALSE 


Name:  MODiN  *  (CASSIN  ') 

Port  Address:  FC  —  FF 

Access:  READONLY 

Description:  Configuration  Status 


DO 

=  o 

D1 

=  CASSMOTORON  STATUS 

D2 

=  MODSEL  STATUS 

D3 

-  ENALTSET  STATUS 

D4 

-  ENEXTIO  STATUS 

D5 

=  (NOT  USED) 

D6 

=  FAST  STATUS 

D7 

=  o 

Name:  LPOUT  * 

Port  Address:  F8  — FB 
Access:  WRITE  ONLY 

Description:      Output  data  to  line  printer 

DO  — D7      =  ASCII  BYTE  TO  BE  PRINTED 


=  BUSY 
1  -  TRUE 
0  =  FALSE 


Name:  DRVSEL * 

Port  Address:  F4  — F7 

Access:  WRITE  ONLY 

Description:  Output  FDC  Configuration 

Note:      Output  to  this  port  will  ALWAYS  cause  a  1  -2  msec 
(Microsecond)  wait  to  the  Z80 


DO 

=  DRIVE  SELECT  0 

D1 

-  DRIVE  SELECT  1 

D2 

=  (RESERVED) 

D3 

=  (RESERVED) 

D4 

=  SDSEL 

0  =  SIDE  0 

1  =  SIDE  1 

D5  =  PRECOMPEN 

0  =  No  write  precornpensation 

1  =  Write  Precornpensation  enabled 

D6  =  WSGEN 

0  =  No  wait  state  generated 

1  =  wait  state  generated 

Note:      This  wait  state  is  to  sync  Z80  with  FDC  chip  during 
FDC  operation 

D7  -  DDEN  * 

0  =  Single  Density  enabled  (FM) 

1  -  Double  Density  enabled  (MFM) 
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Name:  DISKOUT  * 

Port  Address:  FO— F3 

Access:  WRITE  ONLY 

Description:  Output  to  FDC  Control  Registers 

Port  FO  =  FDC  Command  Register 

PortFI  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  -  FDC  Data  Register 

(Refer  to  FDC  Manual  tor  Bit  Assignments) 

Name:  DiSKIN  * 

Port  Address:  FO—  F3 

Access:  READONLY 

Description:  Input  FDC  Control  Registers 

Pert  FO  -  FDC  5f?,M<:;  Rpntqfpr 

Port  F1  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  =  FDC  Data  Register 

(Refer  to  FDC  Manual  for  Bit  Assignment) 


Name:  MODOUT  * 

Port  Address:  EC  — EF 

Access:  WRITE  ONLY 

Description:  Output  to  Configuration  Latch 

DO  =  (RESERVED) 

D1  =  CASSMOTORON  (Sound  enable) 

0  =  Cassette  Motor  Off  (Sound  enabled) 

1  =  Cassette  Motor  On  (Sound  disabled) 

D2  =  MODSEL 

0  =  64  or  80  character  mode 

1  =  32  or  40  character  mode 

D3  =  ENALTSET 

0  =  Alternate  character  set  disabled 

1  =  Alternate  character  set  enabled 


D4 

=  ENEXTSO 

0  ^  External  IO  Bus  disabled 

i  =  External  IO  Bus  enabled 

D5 

- (RESERVED) 

D6 

=  FAST 

0  =  2  MHZ  Mode 

1  =  4  MHZ  Mode 

D7 

=  (RESERVED) 

Name:  RTCIN  * 

Port  Address:  EC  — EF 

Access:  READ  ONLY 

Description:      Clear  Real  Time  Clock  Interrupt 

DO  — D7      =  DON  T  CARE 


Name:  RS2320UT ' 

Port  Address:   E8  — EB 
Access:  WRITE  ONLY 

Description:      UART  Control,  Data  Control.  Modem  Control. 
BRG  Control 

Port  E8  =  UART  Master  Reset 

Port  E9  -  BAUD  Rate  Gen  Register 

Port  EA  =  UART  Control  Register  (Modem  Control  Reg  ) 

Port  EB  =  UART  Transmit  Holding  Reg 

(Refer  to  Model  Ml  or  4  Manual  for  Bit  Assignments) 

Name:  RS232IN  * 

Port  Address:  E8  — EB 

Access:  READ  ONLY 

Description:  Input  UART  and  Modem  Status 

Port  E8  =  MODEM  STATUS 

PortE9  =  (RESERVED) 

Port  EA  =  UART  Status  Register 

Port  EB  =  UART  Receive  Holding  Register  (Resets  DR) 

(Refer  to  Model  Ml  or  4  Manual  for  Bit  Assignments) 
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Name:  WRNMIMASKREG  * 

Port  Address:  E4—E7 

Access:  WRITE  ONLY 

Description:  Output  NMi  Lalch 

DO  — D5      =  (RESERVED) 

D6  -  ENMOTOROFFINT 

0  =  Disables  Motoroff  NMI 

1  =  Enables  Motoroif  NMI 


-  ENRECSNT 

0  -  RS232  Rec  Data  Reg  full  in!  disabled 

1  =  RS232  Rec  Data  Reg  full  int  enabled 

=  ENERRORiNT 

0  -  RS232  UART  Error  interrupts  disabled 

1  =  RS232  UART  Error  interrupts  enabled 

=  (RESERVED) 


■■  ENINTRQ 

0  =  Disables  INTRQ  NMi 

1  =  Enables  INTRQ  NMI 


Name:  RDNMISTATUS " 

Port  Address:  E4  — E7 

Access:  READ  ONLY 

Description:  Input  NMI  Status 


DO 


=  0 


D2  — D4      -{RESERVED} 
D5 


-  RESET  {not  needed) 

0  ^  Reset  Asserted  {Problem} 

1  =  Reset  Negated 

=  MOTOROFF 

0  =  Motoroff  Asserted 

1  =  Motoroff  Negated 

-  INTRQ 

0  =  INTRQ  Asserted 

1  =  INTRQ  Negated 


Name:  WRiNTMASKREG  * 

Port  Address:  EO  —  E3 

Access:  WRITE  ONLY 

Description:  Output  INT  Latch 


Name:  RDINTSTATUS  * 

Port  Address:  EG— E3 

Access:  READ  ONLY 

Description:  Input  INT  Status 

DO— D1       -  (RESERVED) 


D2 

=  RTC  INT 

D3 

=  IOBUS  INT 

D4 

-  RS232XMITINT 

D5 

=  RS232  REC  INT 

D6 

-  RS232  UART  ERROR  INT 

D7 

=  (RESERVED) 

Name:  BOOT  * 

Port  Address:  9C  — 9F 
Access:  WRITE  ONLY 

Description:      Enable  or  Disable  Boot  ROM 

DO  =  ROM  * 

0  =  Boot  ROM  Disabled 

1  -  Boot  ROM  Enabled 

D1  — D7      =  (RESERVED) 


DO  — D1       =  (RESERVED) 

D2  =  ENRTC 

0  =  Real  time  clock  interrupt  disabled 

1  =  Real  time  clock  interrupt  enabled 

D3  =  ENIOBUSSNT 

0  =  External  10  Bus  interrupt  disabled 

1  =  External  iO  Bus  interrupt  enabled 

D4  =  ENXMITINT 

0  =  RS232  Xmit  Holding  Reg    empty  int 
disabled 

1  =  RS232  Xmit  Holding  Reg   empty  int 
enabled 


Name:  SEN  * 

Port  Address:  90  —  93 

Access:  WRITE  ONLY 

Description:  Sound  output 

DO  =  SOUND  DATA 

D1 — D7      =  (RESERVED) 
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Name:  OPREG  * 

Port  Address:  84 

Access:  WRITE  ONLY 

Description:  Output  to  operation  reg 


DO 


=  SELO 


SEL1 
0 
0 

1 
1 

SELO 
0 

1 
0 

1 

MODE 
0 
1 
2 

3 

8064 

0  =  64  character  mode 

1  =  80  character  mode 

■■  INVERSE 

0  =  Inverse  video  disabled 

1  =  Inverse  video  enabled 

=  SRCPAGE  —  Points  to  the  page  to  be  mapped 
as  new  page 

0  =  U64K,  L32K  Page 

1  =  U64K,  U32K  Page 

=  ENPAGE  —  Enables  mapping  of  new  page 

0  =  Page  mapping  disabled 

1  =  Page  mapping  enabled 

=  DESPAGE  —  Points  to  the  page  where  new 
page  is  to  be  mapped 

0  =  L64K,  U32K  Page 

1  =  L64K,  L32K  Page 

=  PAGE 

0  =  Page  0  of  Video  Memory 

1  =  Page  1  of  Video  Memory 
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3.1,8  Video  Circuit 

The  heart  of  the  video  display  circuit  in  the  Model  4P  is  the 
68045  Cathode  Ray  Tube  Controller  (CRTC),  U85  The  CRTC 
is  a  preprogrammed  video  controller  that  provides  two  screen 
formats:  64  by  1 6  and  80  by  24  The  format  is  controlled  by  pin 
3  of  the  CRTC  (8064*)  The  CRTC  generates  all  of  the  neces- 
sary signals  required  for  the  video  display  These  signals  are 
VSYNC  (Vertical  Sync),  HSYNC  (Horizontal  Sync)  for  proper 
sync  of  the  monitor.  DISPEN  (Display  Enable)  which  indicates 
when  video  data  should  be  output  to  the  monitor,  the  refresh 
memory  addresses  (MA0-MA13)  which  addresses  the  video 
RAM,  and  the  row  addresses  (RA0-RA4)  which  indicates  which 
scan  line  row  is  being  displayed  The  CRTC  also  provides  hard- 
ware scrolling  by  writing  to  the  internal  Memory  Start  Address 
Register  by  OUTing  to  Port  88H  The  internal  cursor  control  of 
the  68045  is  not  used  in  the  Model  4P  video  circuit 

Since  the  80  by  24  screen  requires  1 ,920  screen  memory  lo- 
cations, a  2K  by  8  static  RAM  (U82)  is  used  for  the  video  RAM 
Addressing  to  the  video  RAM  (U82)  is  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating  of 
the  data  is  performed  These  two  sets  of  address  lines  are  mul- 
tiplexed by  three  74LS157s  (U83,  U84,  and  U104)  The  multi- 
plexers are  switched  by  CRTCLK  which  allows  the  CRTC  to 
address  the  video  RAM  during  the  high  state  of  CRTCLK  and 
the  CPU  access  during  the  low  state  A10  from  the  CPU  is  con- 
trolled by  PAGE*  which  allows  two  display  pages  in  the  64  by 
1 6  format.  When  updates  to  the  video  RAM  are  performed  by 
the  CPU,  the  CPU  is  held  in  a  WAIT  state  until  the  CRTC  is  not 
addressing  the  video  RAM  This  operation  allows  reads  and 
writes  to  video  RAM  without  causing  hashing  on  the  screen 
The  circuit  that  performs  this  function  is  a  74LS244  buffer 
(U103),  an  8  bit  transparent  latch,  74LS373  (U1 02)  and  a  Delay 
Sine  circuit  shared  with  Dynamic  RAM  timing  circuit  consisting 
of  a  74LS74  (U95),  74LS32  (U94),  74LS04  (U74),  74LS00 
(U96),  74LS02  (U75),  and  Delay  Line  (U97).  During  a  CPU 
Read  Access  to  the  Video  RAM,  the  address  is  decoded  by  the 
PAL  U109  and  asserts  VIDEO*  low  This  is  inverted  by  U74  (1/ 
6  of  74LS04)  which  pulls  one  input  of  U96  (1/4  of  74LS00)  and 
in  turn  asserts  VWAIT  *  low  to  the  CPU  RD  is  high  at  this  time 
and  is  latched  into  U95  (1/2  of  74LS74)  on  the  rising  edge  of 
XADR7V  XADR7*  is  inverse  of  CRTCLK  which  drives  the 
CRTC  (68045),  and  the  address  multiplexers  U83,  U84,  and 
U104 


When  RD  is  latched  by  U95,  the  Q  output  goes  low  releasing 
WAIT'  from  the  CPU.  The  same  signal  also  is  sent  to  the  Delay 
Line  (U97)  through  U1 16  (1/4  of  74F08)  The  Delay  line  delays 
the  falling  edge  240  ns  for  VLATCH*  which  latches  the  read 
data  from  the  video  RAM  at  U102  The  data  is  latched  so  the 
CRTC  can  refresh  the  next  address  location  and  prevent  any 
hashing  MRD'  decoded  by  U 108  and  a  memory  read  is  ORed 
with  VIDEO*  which  enables  the  data  from  U1 02  to  the  data  bus 
The  CPU  then  reads  the  data  and  completes  the  cycle  A  CPU 
write  is  slightly  more  complex  in  operation  As  in  the  RD  cycle, 
VIDEO'  is  asserted  low  which  asserts  VWAIT*  low  to  the  CPU 
WR  is  high  at  this  time  which  is  NANDed  with  VIDEO  and 
synced  with  CRTCLK  to  create  VRAMDIS  that  disables  the 
video  RAM  output  On  the  rising  edge  of  XADR7*,  WR  is 
latched  into  U95  (1/2  of  74LS74)  which  releases  VWAIT*  and 
starts  cycle  through  the  Delay  Line.  After  30ns  DLYVWR*  (De- 
layed video  write)  is  asserted  low  which  also  asserts  VBUFEN* 
(Video  Buffer  Enable)  low.  VBUFEN*  enabled  data  from  the 
Data  bus  to  the  video  RAM  Approximately  120ns  later 
DLYVWR*  is  negated  high  which  writes  the  data  to  the  video 
RAM  and  negates  VBUFEN*  turning  off  buffer  The  CPU  then 
completes  WR  cycle  to  the  video  RAM  Refer  to  Video  RAM 
CPU  Access  Timing  Figure  5-12  for  timing  of  above  RD  or  WR 
cycles. 

During  screen  refresh,  CRTCLK  is  high  allowing  the  CRTC  to 
address  Video  RAM  The  data  out  of  the  video  RAM  is  latched 
by  LOAD*  into  a  74LS273  (U101).  D7  is  generated  by  IN- 
VERSE* through  U125  (1/6  of  74S04),  and  U123  (1/4  of 
74LS08) .  This  decoding  determines  if  character  should  be  al- 
pha-numeric only  (if  inverse  high)  or  unchanged  (INVERSE* 
low)  The  outputs  of  U101  are  used  as  address  inputs  the  char- 
acter generator  ROM  (U42).  A9  is  decoded  with  ENALTSET 
(Enable  Alternate  Set)  and  Q7  of  U101,  which  resets  A9  to  a 
low  if  Q7  and  ENALTSET  are  high  See  ENALTSET  Control  Ta- 
ble be  low 
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RA0-RA3,  row  addresses  from  the  CRTC  are  used  to  control 
which  scan  Sine  is  being  displayed  The  Model  4P  has  a  4-bit  full 
adder  74LS283  (U61)  to  modify  the  Row  address  During  a 
character  display  DLYGRAPHIC*  is  high  which  applies  a  high  to 
al!  4  bits  to  be  added  to  row  address  This  will  result  in  subtract- 
ing one  from  Row  address  count  and  allow  all  characters  to  be 
displayed  one  scan  line  lower.  The  purpose  is  so  inverse  char- 
acters wil!  appear  within  the  inverse  block  When  a  graphic 
block  is  displayed  DLYGRAPHIC"  is  low  which  causes  the  row 
address  to  be  unmodified  Moving  jumper  from  E14-E15  to 
E15-E16  will  disable  this  circuit 

DLYCHAR*  and  DLYGRAPHICS  are  inverse  signals  and  con- 
trol which  data  is  to  be  loaded  into  the  shift  register  U63, 
When  DLYCHAR"  is  low  and  DLYGRAPHIC*  is  high,  the 
Character  Generator  ROM  (U42)  is  enabled  to  output  data: 
when  DLYCHAR*  is  high  and  DLYGRAPHIC  is  low  the 
graphics  characters  from  U41  (74LS15)  is  buffered  by  U43 
(74LS244)  to  the  shift  register.  The  data  is  loaded  into  the 
shift  register  on  the  rising  edge  of  SHIFT*  when  LOADS*  is 
low  Blanking  is  accomplished  by  masking  off  LOADS"  so  no 
data  will  be  loaded  and  zero  data  will  be  shifted  out  with  the 
serial  input  of  U63,  pin  1,  grounded  Serial  video  data  is  out- 
put U63  pin  13  and  is  mixed  with  inverse  and/or  hires  graph- 
ics information  by  (1/4  or  74LS86}  U143  The  video  data  is 
then  mixed  with  a  D07  Rate  clock,  either  DOT*  and  DCLK, 
to  create  distinct  dots  on  the  monitor,  DOT*  and  DCLK  are 
inverse  signals  and  are  provided  to  allow  a  choice  to  obtain 
the  best  video  results  The  video  information  is  filtered  by 
F34,  R45  (47  ohm  resistor),  and  C241  (100  pf  Cap)  and  out- 
put to  video  monitor  VSYNC  and  HSYNC  are  buffered  by 
(1/2  of  74LS86)  U143  and  are  also  output  to  video  monitor 
Refer  to  Video  Circuit  Timing  Figure  3-13,  Video  Blanking 
Timing  Figure  3-14,  and  Inverse  Video  Timing  Figure  3-15 
for  timing  relationships  of  Video  Circuit 

3.1.9  Keyboard 

The  keyboard  interface  of  the  Model  4P  consists  of  open  col- 
lector drivers  which  drive  an  8  by  8  key  matrix  keyboard  and  an 
inverting  buffer  which  buffers  the  key  or  keys  pressed  on  the 
data  bus  The  open  collector  drivers  (U56  and  U57  (7416)  are 
driven  by  address  lines  A0-A7  which  drive  the  column  lines  of 
the  keyboard  matrix  The  ROW  lines  of  the  keyboard  are  pulled 
up  by  a  1  5  kohm  resistor  pack  RP2.  The  ROW  lines  are  buff- 
ered and  inverted  onto  the  data  bus  by  U58  (74LS240)  which  is 
enabled  when  KEYBD"  is  a  logic  low  KEYBD"  is  a  memory 
mapped  decode  of  addresses  3800-3BFF  in  Model  HE  Mode 
and  F400-F7FF  in  Model  4/4P  mode.  Refer  to  the  Memory  Map 
under  Address  Decode  for  more  information.  During  real  time 
operation,  the  CPU  wil!  scan  the  keyboard  periodically  to  check 
if  any  keys  are  pressed  If  no  key  is  pressed,  the  resistor  pack 
RP2  keeps  the  inputs  of  U58  at  a  logic  high  U58  inverts  the 
data  to  a  logic  low  and  buffers  it  to  the  data  bus  which  is  read 
by  the  CPU  if  a  key  is  pressed  when  the  CPU  scans  the  correct 
column  line,  the  key  pressed  will  pull  the  corresponding  row  to 
a  logic  low,  U58  inverts  the  signal  to  a  logic  high  which  is  read 
by  the  CPU 


3.1.10  Real  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4P  provides  a  30  Hz 
(in  the  2  MHz  CPU  mode)  or  60  Hz  (in  the  4  MHz  CPU  mode) 
interrupt  to  the  CPU.  By  counting  the  number  of  interrupts  that 
have  occurred,  the  CPU  can  keep  track  of  the  time  The  60  Hz 
vertical  sync  signal  (VSYNC)  from  the  video  circuitry  is  used  for 
the  Real  Time  Clock's  reference  In  the  2  MHz  mode,  FAST  is 
a  logic  low  which  sets  the  Preset  input,  pin  4  of  U22  (74LS74), 
to  a  logic  high  This  allows  the  60  Hz  (VSYNC)  to  be  divided  by 
2  to  30  Hz  The  output  of  1/2  of  U22  is  ORed  with  the  original 
60  Hz  and  then  clocks  another  74LS74  (1/2  of  U22)  If  the  real 
time  clock  is  enabled  (ENRTC  at  a  logic  high),  the  interrupt  is 
latched  and  pulls  the  INT*  line  low  to  the  CPU  When  the  CPU 
recognizes  the  interrupt,  the  pulse  is  counted  and  the  latch  re- 
set by  pulling  RTCIN'  low  In  the  4  MHz  mode,  FAST  is  a  logic 
high  which  keeps  the  first  half  of  U22  in  a  preset  state  (the  Q* 
output  at  a  logic  low).  The  60  Hz  is  used  to  clock  the  interrupts 

NOTE:  If  interrupts  are  disabled,  the  accuracy  of  the  real 
time  clock  will  suffer 

3.1.11  Line  Printer  Port 

The  Line  Printer  Port  interface  consists  of  a  pulse  generator,  an 
eight-bit  latch,  and  a  status  line  buffer  The  status  of  the  line 
printer  is  read  by  the  CPU  by  enabling  buffer  U3  (74LS244) 
This  buffer  is  enabled  by  LPRD*  which  is  a  memory  map  and 
port  map  decode  In  Model  III  mode,  only  the  status  can  be  read 
from  memory  location  37E8  or  37E9  The  status  can  be  read  in 
all  modes  by  an  input  from  ports  F8-FB  For  a  listing  of  the  bit 
status,  refer  to  Port  Map  section. 

After  the  printer  driver  software  determines  that  the  printer  is 
ready  for  printing  (by  reading  the  correct  status),  the  characters 
to  be  printed  are  output  to  Port  F8-FB  U2,  a  74LS374  eight-bit 
latch,  latches  the  character  byte  and  outputs  to  the  line  printer 
One-half  of  U1  (74LS123),  a  one-shot,  is  then  triggered  which 
generates  an  appropriate  strobe  signal  to  the  printer  which  sig- 
nifies a  valid  character  is  ready,  The  output  of  the  one-shot  is 
buffered  by  1  /6th  of  the  U21  (74LS04)  to  prevent  noise  from  the 
printer  cable  from  ftase-triggering  the  one-shot 
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3.1.12  Graphics  Port 


The  Graphics  Port  (J7)  on  the  Model  4P  is  provided  to  attach 
the  optional  Graphics  Board.  The  port  provides  D0-D7  {Data 
Lines},  A0-A3  (Address  Lines),  IN*,  GEN*  and  RESET*  for  the 
necessary  interface  signals  for  the  Graphics  Board  GEN*  is 
generated  by  negative  ORing  Port  selects  GSELO*  (8C-8FH) 
and  GSELI*  (80-83H)  together  by  (1/4  of  74LS08)  U23  The  re- 
suiting  signal  is  negative  ANDed  with  IORQ*  by  (1/4  of  74S32} 
U62  Seven  timing  signals  are  provided  to  allow  synchroniza- 
tion of  Main  Logic  Board  Video  and  Graphics  Board  Video 
These  timing  signals  are  VSYNC,  HSYNC,  DISPEN,  DCLK,  H, 
i,  and  J  Three  control  signals  from  the  Graphics  Board  are 
used  to  sync  to  CPU  access  and  select  different  video  modes 
WAIT'  controls  the  CPU  access  by  causing  the  CPU  to  WAIT  till 
video  is  in  retrace  area  before  allowing  any  writes  or  reads  to 
Graphics  Board  RAM  ENGRAF  is  asserted  when  Graphics 
video  is  displayed  ENGRAF  also  disables  inverse  video  mode 
on  Main  Logic  Board  Video.  CL166*  (Clear  74L166)  is  used  to 
enable  or  disable  mixing  of  Main  Logic  Board  Video  and  Graph- 
ics Board  Video  If  CL166*  is  negated  high,  then  mixing  is  al- 
lowed in  all  for  video  modes  80  x  24,  40  x  24, 64  x  1 6,  and  32  x 
16  if  CL166*  is  asserted  low,  this  will  clear  the  video  shift  reg- 
ister U63,  which  allows  no  video  from  the  Main  Logic  Board  In 
this  state  8064*  is  automatically  asserted  low  to  put  screen  in 
80  x  24  video  mode  Refer  to  Figure  3-16  Graphic  Board 
Video  Timing  for  timing  relationships  Refer  to  the  Model  4/ 
4P  Graphics  Board  Service  information  for  service  or  techni- 
cal information  on  the  Graphics  Board. 

3.1.13  Sound 

The  sound  circuit  in  the  Model  4P  is  compatible  with  the  Sound 
Board  which  was  optional  in  the  Model  4  Sound  is  generated 
by  alternately  setting  and  clearing  data  bit  DO  during  an  OUT  to 
port  90H  The  state  of  DO  is  latched  by  U130  (1/2  of  a  74LS74) 
and  the  output  is  amplified  by  Q2  which  drives  a  piezoelectric 
sound  transducer  The  speed  of  the  software  loop  determines 
the  frequency,  and  thus,  the  pitch  of  the  resulting  tone  Since 
the  Model  4P  does  not  have  a  cassette  circuit,  some  existing 
software  that  used  the  cassette  output  for  sound  would  have 
been  lost  The  Model  4P  routes  the  cassette  latch  to  the  sound 
board  through  U142  When  the  CASSMOTORON  signal  is  a 
logic  low,  the  cassette  motor  is  oft,  then  the  cassette  output  is 
sent  to  the  sound  circuit 

3.1.14  I/O  Bus  Port 

The  Model  4P  Bus  is  designed  to  allow  easy  and  convenient  in- 
terfacing of  I/O  devices  to  the  Model  4P  The  I/O  Bus  supports 
all  the  signals  necessary  to  implement  a  device  compatible  with 
the  Z80s  I/O  structure 


A0  to  A7  allow  selection  of  up  to  256*  input  and  256  output 
devices  if  external  I/O  is  enabled 

'Ports  80H  to  OFFH  are  reserved  for  System  use 

Data: 

DBO  to  DB7  allow  transfer  of  8-bit  data  onto  the  processor 
data  bus  is  external  I/O  is  enabled 

Control  Lines: 

1  M1*  —  Z80A  signal  specifying  an  M1  or  Operation  Code 
Fetch  Cycle  or  with  IOREQ*,  it  specifies  an  Interrupt 
acknowledge 

2  IN*  —  Z80A  signal  specifying  than  an  input  is  in  progress 
Logic  AND  of  IOREQ*  and  WR* 

3  OUT*  —  Z80A  signal  specifying  that  an  output  is  in  prog- 
ress Logic  AND  of  IOREQ*  and  WR* 

4  IOREQ*  —  Z80A  signal  specifying  that  an  input  or  output 
is  in  progress  or  with  M1*,  it  specifies  an  interrupt 
acknowledge 

5  RESET*  —  system  reset  signal 

6  IOBUSINT*  — -  input  to  the  CPU  signaling  an  interrupt  from 
an  I/O  Bus  device  if  I/O  Bus  interrupts  are  enabled 

7  IOBUSWAIT*  —  input  to  the  CPU  wait  line  allowing  I/O  Bus 
device  to  force  wait  states  on  the  Z80  if  external  I/O  is 
enabled 

8  EXTIOSEL*  —  input  to  I/O  Bus  Port  circuit  which  switches 
the  I/O  Bus  data  bus  transceiver  and  allows  and  INPUT  in- 
struction to  read  I/O  Bus  data 

The  address  line,  data  line,  and  all  control  lines  except  RESET* 
are  enabled  only  when  the  ENEXIO  bit  in  port  EC  is  set  to  one 

To  enable  I/O  interrupts,  the  ENSOBUSINT  bit  in  the  PORT  E0 
(output  port)  must  be  a  one  However,  even  if  it  is  disabled  from 
generating  interrupts,  the  status  of  the  IOBUSINT*  line  can  still 
read  on  the  appropriate  bit  of  CPU  IOPORT  E0  (input  port) 

See  Model  4P  Port  Bit  assignments  for  port  OFF,  OEC,  and  0E0 


Hardware  91 


^ 


Bntna 


r\ 


^^ 


u 


r~ 


— 


c 


0) 

c 

I 
p 

o 

0) 

CD 
O 

m 
o 
jE 
a 

to 

CO 

£ 

0) 
LL 


c 


Q 

fe 

H 

*c 

> 

« 

fa 

o 

<c 

z 

« 

w 

o 

Eh  t-q 

O  O 

Q  O 


E-t 

O 
> 


Hardware  92 


The  Mode!  4P  CPU  board  is  fully  protected  from  foreign  i  0  de- 
vices'' in  that  all  the  I/O  Bus  signals  are  buffered  and  can  be  dis- 
abled under  software  control  To  atlach  and  use  and  I'O  device 
on  the  I/O  Bus,  certain  requirements  (both  hardware  and  soft- 
ware) must  be  met 

For  input  port  device  use,  you  must  enable  external  I/O  de- 
vices by  writing  to  port  OECH  with  bit  4  on  in  the  user  soft- 
ware This  will  enable  the  data  bus  address  lines  and  control 
signals  to  the  I/O  Bus  edge  connector  When  the  input  de- 
vice is  selected,  the  hardware  should  acknowledge  by  as- 
serting EXTIOSEL"  low  This  switches  the  data  bus 
transceiver  and  allows  the  CPU  to  read  the  contents  of  the  1/ 
O  Bus  data  lines  See  Figure  3-17  for  the  timing  EXTIO- 
SEL* can  be  generated  by  NANDing  IN  and  the  I/O  port 
address 

Output  port  device  use  is  the  same  as  the  input  port  device  in 
use,  in  that  the  external  I/O  devices  must  be  enabled  by  writing 
to  port  OECH  with  bit  4  on  in  the  user  software  —  in  the  same 
fashion 

For  either  input  or  output  devices,  the  IOBUSWAIT'  control  line 
can  be  used  in  the  normal  way  for  synchronizing  slow  devices 
to  the  CPU  Note  that  since  dynamic  memories  are  used  in  the 
Mode!  4P.  the  wait  line  should  be  used  with  caution  Holding  the 
CPU  in  a  wait  state  for  2  msec  or  more  may  cause  loss  of  mem- 
ory contents  since  refresh  is  inhibited  during  this  time  It  is  rec- 
ommended that  the  IOBUSWAIT'  line  be  held  active  no  more 
than  500  jxsec  with  a  25%  duty  cycle 

The  Model  4P  will  support  280  Mode  1  interrupts  A  RAM  jump 
table  is  supported  by  the  LEVEL  II  BASIC  ROMs  image  and  the 
user  must  supply  the  address  of  his  interrupt  service  routine  by 
writing  this  address  to  locations  403E  and  403F  When  an  in- 
terrupt occurs,  the  program  will  be  vectored  to  the  user-sup- 
plied address  if  I/O  Bus  interrupts  have  been  enabled  To 
enable  I/O  Bus  interrupts,  the  user  must  set  bit  3  of  Port  OE0H 

3.1.15  FDC  Circuit 

The  TFIS-80  Model  4P  Floppy  Disk  Interface  provices  a  stan- 
dard 5-1/4"  floppy  disk  controller  The  Floppy  Disk  Interface 
supports  both  single  and  double  density  encoding  schemes 
Write  precompensation  can  be  software  enabled  or  disabled 
beginning  at  any  track,  although  the  system  software  enables 
write  precompensation  for  all  tracks  greater  than  twenty-one 
The  amount  of  write  precompensation  is  250  nsec  and  is  not 
adjustable  The  data  clock  recovery  logic  incorporates  a  digital 
data  separator  which  achieves  state-of-the-art  reliability  One 
or  two  drives  may  be  controlled  by  the  interface  All  data  trans- 
fers are  accomplished  by  CPU  data  requests  In  double  density 
operation,  data  transfers  are  synchronized  to  the  CPU  by  forc- 
ing a  wait  to  the  CPU  and  clearing  the  wait  by  a  data  request 
from  the  FDC  chip  The  end  of  the  data  transfer  is  indicated  by 
generation  of  a  non-maskable  interrupt  from  the  interrupt  re- 
quest output  of  the  FDC  chip  A  hardware  watchdog  timer  in- 
sures that  any  error  condition  will  not  hang  the  wait  line  to  She 
CPU  for  a  period  long  enough  to  destroy  RAM  consents 
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Control  and  Data  Buffering 


'Only  one  of  these  bits  should  be  set  per  output 


The  Floppy  Disk  Controller  Board  is  an  I/O  port-mapped  device 
which  utilizes  ports  E4H.  FOH.  F1H.  F2H.  F3H.  and  F4H  The 
decoding  logic  is  implemented  on  the  CPU  board  (Refer  to  Par- 
agraph  5  1  5  Address  Decoding  for  more  information  on  Port 
Map)  U31  is  a  bi-directional.  8-bit  transceiver  used  to  buffer 
data  to  and  from  the  FDC  and  RS-232  circuits  The  direction  of 
data  transfer  is  controlled  by  the  combination  of  controi  signals 
DISKIN*  and  RS232IN*  If  eithersignal  is  active  (logic  low).  U31 
is  enabled  to  drive  data  onto  the  CPU  data  bus  ff  both  signals 
are  inactive  (logic  high),  U31  is  enabled  to  receive  data  from  the 
CPU  board  data  bus  A  second  buffer  (U 1 2)  is  used  to  buffer  the 
FDC  chip  data  to  the  FDC/RS232  Data  Bus.  (BD0-BD7).  U 1 2  is 
enabled  all  the  time  and  its  direction  controlled  by  DISKIN* 
Again,  if  DISKfN'  is  active  (logic  low),  data  is  enabled  to  drive 
from  the  FDC  chip  to  the  Main  Data  Busses  If  DISKIN*  is  in- 
active (logic  high),  data  is  enabled  to  be  transferred  to  the  FDC 
chip 

Nonmaskable  Interrupt  Logic 

Dual  D  flip-flop  U1 00  (74LS74)  is  used  to  latch  data  bits  D6  and 
D7  on  the  rising  edge  of  the  control  signal  WRNMIMASKREG* 
The  outputs  of  U100  enable  the  conditions  which  will  generate 
a  non-maskable  interrupt  to  the  CPU  The  NMI  interrupt  con- 
ditions which  are  programmed  by  doing  an  OUT  instruction  to 
port  E4H  with  the  appropriate  bits  set  If  data  bit  7  is  set.  an  FDC 
interrupt  is  enabled  to  generate  an  NMI  interrupt  !f  data  bit  7  is 
reset,  interrupt  requests  request  from  the  FDC  are  disabled  If 
data  bit  6  is  set,  a  Motor  Time  Out  is  enabled  to  generate  an 
NMI  interrupt  if  data  bit  6  is  reset,  interrupts  on  Motor  Time  Out 
are  disabled  An  IN  instruction  from  port  E4H  enables  the  CPU 
to  determine  the  source  of  the  non-maskable  interrupt  Data  bit 
7  indicates  the  status  of  FDC  interrupt  request  (INTRO) 
(0  =  true,  1  -false)  Data  bit  6  indicates  the  status  of  Motor 
Time  Out  (0-true.  1  -false)  Data  bit  5  indicates  the  status  of 
the  Reset  signal  (0  =  'rue.  1  -false)  The  control  signal 
RDNMISTATUS*  gates  this  status  onto  the  CPU  data  bus  when 
active  (logic  low) 

Drive  Select  Latch  and  Motor  ON  Logic 

Selecting  a  drive  prior  to  disk  I/O  operation  is  accomplished  by 
doing  an  OUT  instruction  to  pod  F4H  with  the  proper  bit  set  The 
following  table  describes  the  bit  allocation  of  the  Drive  Select 
Latch: 


Data  Bit 

DO 
D1 
D2 
D3 
D4 


D6 
D7 


Function 

Selects  Drive  0  when  set* 
Selects  Drive  1  when  set* 
Selects  Drive  2  when  set- 
Selects  Drive  3  when  set* 
Selects  Side  0  when  reset 
Selects  Side  1  when  set 
Write  precompensation  enabled  when  set. 
disabled  when  reset 
Generates  WAIT  if  set 
Selects  MFM  mode  if  set 
Selects  FM  mode  it  reset 


Hex  D  flip-flop  U32  (74L174)  latches  the  drive  select  bits,  side 
select  and  FMVMFM  bits  on  the  rising  edge  of  the  control  signal 
DRVSEL*  A  dual  D  flip-flop  (U98)  is  used  to  latch  the  Wait  En- 
able and  Write  precompensation  enable  bits  on  the  rising  edge 
of  DRVSEL*  The  rising  edge  of  DRVSEL'  also  triggers  a  one- 
shot  (1/2  of  U54,  74LS123)  which  produces  a  Motor  On  to  the 
disk  drives  The  duration  of  the  Motor  On  signal  is  approxi- 
mately three  seconds  The  spindle  motors  are  not  designed  for 
continuous  operation  Therefore,  the  inactive  state  of  the  Motor 
On  signal  is  used  to  clear  the  Drive  Select  Latch,  which  de-se- 
lects any  drives  which  were  previously  selected  The  Motor  On 
one-shot  is  retriggerable  by  simply  executing  another  OUT  in- 
struction to  the  Drive  Select  Latch 

Wait  State  Generation  and  WAITIMOUT  Logic 

As  previously  mentioned,  a  wait  state  to  the  CPU  can  be  initi- 
ated by  an  OUT  to  the  Drive  Select  Latch  with  D6  set  Pin  5  of 
U98  will  go  high  after  this  operation  This  signal  is  inverted  by 
1/4th  of  U79  and  is  routed  to  the  CPU  where  it  forces  the  Z80A 
into  a  wait  state  The  Z80A  will  remain  in  the  wait  state  as  long 
as  WAIT*  is  low  Once  initiated,  the  WAIT*  will  remain  low  until 
one  of  five  conditions  is  satisfied  One  half  of  U77  {a  five  input 
NOR  gate)  is  used  to  perform  this  function  INTO,  DRQ,  RE- 
SET. CLRWAIT.  and  WAITIMOUT  are  the  inputs  to  the  NOR 
gate  If  any  one  of  these  inputs  is  active  (logic  high),  the  output 
of  the  NOR  gate  (U77  pin  5)  will  go  low  This  output  is  tied  to  the 
clear  input  of  the  wait  latch  When  this  signal  goes  low,  it  will 
clear  the  Q  output  (U98  pin  5)  and  set  the  Q*  output  (U98  pin 
6).  This  condition  causes  WAIT*  to  go  high  which  allows  the 
Z80  to  exit  the  wait  state  U99  is  a  12-bit  binary  counter  which 
serves  as  a  watchdog  timer  to  insure  that  a  watt  condition  will 
not  persist  long  enough  to  destroy  dynamic  RAM  contents  The 
counter  is  clocked  by  a  1  MHz  clock  and  is  enabled  to  count 
when  its  reset  pin  is  low  (U99  pin  1 1)  A  logic  high  on  U99  pin 
11  resets  the  counter  outputs  U99  pin  15  is  a  divide-by-1024 
output  and  is  used  to  generate  the  signal  WAITIMOUT  This 
watchdog  timer  logic  will  limit  the  duration  of  a  wait  to 
1024jisec.  even  it  the  FDC  chip  should  fail  to  generate  a  DRQ 
or  an  INTRQ 

if  an  OUT  to  Drive  Select  Latch  is  initiated  with  D6  reset  (logic 
low),  a  WAIT  is  still  generated  The  12-bit  binary  counter  will 
count  to  2  which  will  output  CLRWAIT  and  clear  the  WAIT  state 
This  allows  the  WAIT  to  occur  only  during  the  OUT  instruction 
to  prevent  violating  any  Dynamic  RAM  parameters 


NOTE: 


This  automatic  WAIT  will  cause  a  1-2  p.sec  wait  each 
time  an  out  to  Drive  Select  Latch  is  performed 
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Clock  Generation  Logic 

A  4  MHz  crystal  oscillator  and  a  4-bit  binary  counter  are  used  to 
generate  the  clock  signals  required  by  the  FDC  board  The  4 
MHz  oscillator  is  implemented  with  two  inverters  (1-3  of  U39) 
and  a  quartz  crystal  (Y2)  The  output  of  the  oscillator  is  inverted 
and  buffered  by  1  /6  of  U39  to  generate  a  TTL  level  square  wave 
signal  U37  is  a  4-bit  binary  counter  which  is  divided  into  a  di- 
vide-by-2  and  a  divide-by-8  section  The  divide-by-2  section  is 
used  to  generate  the  2  MHz  output  at  pin  12  The  2  MHz  is 
NANDed  with  4MHz  by  1/4  of  U19  and  the  output  is  used  to 
dock  the  divide-by-8  section  of  U37  A  1  MHz  clock  is  gener- 
ated at  pin  9  of  U37  which  is  90"  phase-shifted  from  the  2  MHz 
clock  This  phase  relationship  is  used  to  gate  the  guaranteed 
Write  Data  Pulse  (WD)  to  the  Write  precompensation  circuit 
The  4  MHz  is  used  to  clock  the  digital  data  separator  U18  and 
the  Write  precompensation  shift  register  U55  The  1  MHz  clock 
is  used  to  drive  the  dock  input  of  the  FDC  chip  (U13)  and  the 
dock  input  of  the  watchdog  timer  (U99) 

Disk  Bus  Output  Drivers 

Hiah  current  open  collector  drivers  U20  and  U56  are  used  to 
buffer  the  output  signals  from  the  FDC  circuit  to  the  disk  drives 

Write  Precompensation  and  Write  Data  Pulse  Shap- 
ing Logic 

The  Write  Precompensation  logic  is  comprised  ol  U55 
(74LS195)  1  4  of  U19  (74LS00)  1  4  of  U74  (74LS04)  and 
1/2  of  U77  (74LS260)  U55  is  a  parallel  in  serial  out  shift  reg- 
ister and  is  clocked  by  4  MHz  which  generates  a  precompen- 
sation value  of  250  nsec  The  output  signals  EARLY  and  LATE 
of  the  FDC  chip  (U13)  are  input  to  PO  and  P2  of  the  shift  reg- 
ister A  third  signal  is  generated  by  1  4  of  U75  when  neither 
EARLY  nor  LATE  is  active  low  and  is  input  to  P1  of  U55  WD  of 
the  FDC  chip  is  NANDed  with  2  MHz  to  gate  the  guaranteed 
Write  Data  Pulse  to  U55  for  the  parallel  load  signal  SHFT  LD 
When  U55  pin  9  is  active  low  the  signals  preset  at  P1-P3  are 
clocked  in  on  the  rising  edge  of  the  4  MHz  clock  After  U55  pin 
9  goes  high  the  data  is  shifted  out  at  a  250  nsec  rate  EARLY 
will  generate  a  250  nsec  delay.  NOT  EARLY  AND  NOT  LATE 
will  generate  a  500  nsec  delay  and  LATE  will  generate  a  750 
nsec  delay  This  provides  the  necessary  precompensation  for 
the  write  data  As  mentioned  previously  Write  Precompensa- 
tion is  enabled  through  software  by  an  OUT  to  the  Drive  Select 
Latch  with  bit  5  set  This  sets  the  Q  output  of  the  74LS74  (U98 
pin  9)  which  is  ANDed  with  DDEN  which  disables  the  shift  reg- 
ister U55  DDEN  disables  Write  Precompensation  in  the  single 
density  mode  The  resulting  signal  also  enables  U75  to  allow 
the  write  data  (WD)  to  bypass  the  Write  Precompensation  cir- 
cuit The  Write  Data  (WD)  pulse  is  shaped  by  a  one-shot  (1  2  of 
U54)  which  stretches  the  data  pulses  to  approximately  500 
nsec 
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Clock  and  Read  Data  Recovery  Logic 


BRG  Programming  Table 


The  Clock  and  Read  Data  Recovery  Logic  is  comprised  of  one 
chip  U18  (FDC9216)  The  FDC9216  is  a  Floppy  Disk  Data  Sep- 
arator (FDDS)  which  converts  a  single  stream  of  pulses  from 
the  disk  drive  into  separate  clock  and  data  pulses  for  input  to 
the  FDC  chip  The  FDDS  consists  of  a  clock  divider,  a  long-term 
timing  corrector,  a  short-time  timing  corrector  and  reclocking 
circuitry  The  reference  clock  (REFCLK)  is  a  4  MHz  and  is  di- 
vided by  the  internal  clock  divider  CDO  and  CD1  of  the  FDDS 
chip  control  the  divisor  which  divides  REFCLK  With  DC1 
grounded  (logic  low),  CDO  (when  a  logic  low)  generates  a  ds- 
vide-by-1  for  MFM  mode  and  when  logic  high  generates  a  di- 
vide-by-2  for  FM  mode  CDO  is  controlled  by  the  signal  DDEN* 
which  is  Double  Density  enable  or  MFM  enable  The  FDDS  de- 
tects the  leading  edges  of  RD*  pulses  and  adjusts  the  phase  of 
the  internal  clock  to  generate  the  separated  clock  (SEPCLK)  to 
the  FDC  chip  The  separate  long  and  short  term  timing  correc- 
tors assure  the  clock  separation  to  be  accurate  The  separated 
Data  (SEPD*)  is  used  as  the  RDD*  input  to  the  FDC  chip 

Floppy  Disk  Controller  Chip 

The  1793  is  an  MOS  LSI  device  which  performs  the  functions 
of  a  floppy  disk  formatter/controller  in  a  single  chip  implemen- 
tation The  following  port  addresses  are  assigned  to  the  internal 
registers  of  the  1 793  FDC  chip: 

Port  No.  Function 

FOH  Command/Status  Register 

F1H  Track  Register 

F2H  Sector  Register 

F3H  Data  Register 


3.1.16  RS-232-C  Circuit 
RS-232C  Technical  Description 

The  RS-232C  circuit  for  the  Model  4P  computer  supports  asyn- 
chronous serial  transmissions  and  conforms  to  the  EIA  RS- 
232C  standards  at  the  input-output  interface  connector  (J4) 
The  heart  of  the  circuit  is  the  TR1865  Asynchronous  Receiver/ 
Transmitter  U30  It  performs  the  job  of  converting  the  parallel 
byte  data  from  the  CPU  to  a  serial  data  stream  including  start, 
stop,  and  parity  bits  For  a  more  detailed  description  of  how  this 
LSI  circuit  performs  these  functions,  refer  to  the  TR1865  data 
sheets  and  application  notes  The  transmit  and  receive  clock 
rates  that  the  TR1865  needs  are  supplied  by  the  Baud  Rate 
Generator  U52  (BR1941L)  or  (BR1943)  This  circuit  takes  the 
5  0688  MHz  supplied  by  the  system  timing  circuit  and  the  pro- 
grammed information  received  from  the  CPU  over  the  data  bus 
and  divides  the  basic  clock  rate  to  provide  two  clocks  The  rates 
available  from  the  BRG  go  from  50  Baud  to  19200  Baud  See 
the  BRG  table  for  the  complete  list 


Transmit/ 

Receive 

Supported 

Nibble 

Baud 

16X 

by 

Loaded 

Rate 

Clock 

SETCOM 

OH 

50 

08  kHz 

Yes 

1H 

75 

1  2  kHz 

Yes 

2H 

110 

1  76  kHz 

Yes 

3H 

134  5 

2  1523  kHz 

Yes 

4H 

150 

2  4  kHz 

Yes 

5H 

300 

4.8  kHz 

Yes 

6H 

600 

9.6  kHz 

Yes 

7H 

1200 

19.2  kHz 

Yes 

8H 

1800 

28  8  kHz 

Yes 

9H 

2000 

32.081  kHz 

Yes 

AH 

2400 

38  4  kHz 

Yes 

BH 

3600 

57  6  kHz 

Yes 

CH 

4800 

76  8  kHz 

Yes 

DH 

7200 

115  2  kHz 

Yes 

EH 

9600 

153  6  kHz 

Yes 

FH 

19200 

307  2  kHz 

Yes 

The  RS-232C  circuit  is  port  mapped  and  the  ports  used  are  E8 
to  EB  Following  is  a  description  of  each  port  on  both  input  and 
output 


Port 

Input 

Output 

E8 

Modem  status 

Master  Reset,  enables  UART 
control  register  load 

EA 

UART  status 

UART  control  register  load  and 
modem  control 

E9 

Not  Used 

Baud  rate  register  load  enable 
bit 
Transmitter  Holding  register 

EB 

Receiver  Holding 

register 

interrupts  are  supported  in  the  RS-232C  circuit  by  the  Interrupt 
mask  register  (U92)  and  the  Status  register  (U44)  which  allow 
the  CPU  to  see  which  kind  of  interrupt  has  occurred  Interrupts 
can  be  generated  on  receiver  data  register  full,  transmitter  reg- 
ister empty,  and  any  one  of  the  errors  —  parity,  framing,  or  data 
overrun  This  allows  a  minimum  of  CPU  overhead  in  transfer- 
ring data  to  or  from  the  UART  The  interrupt  mask  register  is 
port  E0  (write)  and  the  interrupt  status  register  is  port  E0  (read) 
Refer  to  the  IO  Port  description  for  a  lull  breakdown  of  all  inter- 
rupts and  their  bit  positions 
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Ali  Model  I,  III.  and  4  software  written  lor  the  RS-232-C  interface 
is  compatible  with  the  Model  4P  RS-232-C  circuit,  provided  the 
software  does  not  use  the  sense  switches  to  configure  the  in- 
terface The  programmer  can  get  around  this  problem  by  di- 
rectly programming  the  BRG  and  UART  for  the  desired 
configuration  or  by  using  the  SETCOM  command  of  the  disk 
operating  system  to  configure  the  interface  The  TRS-80  RS- 
232C  Interface  hardware  manual  has  a  good  discussion  of  the 
RS-232C  standard  and  specific  programming  examples  (Cat- 
alog Number  26-1 145) 

Ptnout  Listing 

The  following  list  is  a  pinout  description  of  the  DB-25  connector 
(P1). 


Pin  No. 

Signal 

1 

PGND  (Protective  Ground) 

2 

TD  {Transmit  Data) 

3 

RD  (Receive  Data) 

4 

RTS  (Request  to  Send) 

5 

CTS  (Clear  To  Send) 

6 

DSR  (Data  Set  Ready) 

7 

SGND  (Signal  Ground) 

8 

CD  (Carrier  Detect) 

19 

SRTS  (Spare  Request  to  Send) 

20 

DTR  (Data  Terminal  Ready) 

22 

Rl  (Ring  Indicate) 
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SECTION  IV 


4P  GATE  ARRAY  THEORY  OF  OPERATION 
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4.2  MODEL  4P  GATE  ARRAY  THEORY  OF 
OPERATION 

4.2.1  introduction 

Contained  in  the  following  paragraphs  is  a  description  of  the 
component  parts  ol  the  Mode!  4P  CPU  Gate  Array  It  is  divided 
into  the  logical  operational  functions  of  the  computer  All  com- 
ponents are  located  on  the  Main  CPU  board  inside  the  case 
housing  Refer  to  Section  3  for  disassembly/assembly 
procedures 

4.2.2  Reset  Circuit 

The  Model  4P  reset  circuit  provides  the  neccessary  reset 
pulses  to  ail  circuits  during  power  up  and  reset  operations  R25 
and  C21 4  provide  a  time  constant  which  holds  the  input  of  U121 
low  during  power-up  This  allows  power  to  be  stable  to  all  cir- 
cuits before  the  RESET*  and  RESET  signals  are  applied  When 
C214  charges  to  a  logic  high,  the  output  of  U121  triggers  the 
input  of  a  retriggerable  one-shot  multivibrator  (U1)  U1  outputs 
a  pulse  with  an  approximate  width  of  70  microsecs  When  the 
reset  switch  is  pressed  on  the  front  panel,  this  discharges  C214 
and  holds  the  input  of  U1 21  low  until  the  switch  is  released  On 
release  of  the  switch,  C21 4  again  charges  up.  triggering  U1 21 
and  U1  to  reset  the  microcomputer  Another  signal  POWRST* 
is  generated  to  clear  drive  select  circuit  immediately  when 
reset  switch  is  pressed 

4.2.3  CPU 

The  central  processing  unit  (CPU)  of  the  Model  4P  microcom- 
puter is  a  Z80A  microprocessor  The  Z80A  is  capable  of  run- 
ning in  either  2  MHz  or  4  MHz  mode  The  CPU  controls  all 
functions  of  the  microcomputer  through  use  of  its  address  Sines 
(A0-A15),  data  lines  (D0-D7),  and  control  lines  (/M1t  /IOREQ. 
/RD.  /WR,  /MREQ,  and  /RFSH)  The  address  Sines  (A0-A15) 
are  buffered  to  other  ICs  through  two  74LS244s  (U67  and  U27) 
which  are  enabled  all  the  time  with  their  enables  pulled  to  GND 
The  control  lines  are  buffered  to  other  ICs  through  a  74F04 
(U87)  The  data  lines  (D0-D7)  are  buffered  through  a  bi-direc- 
tional 74LS245  (U86)  which  is  enabled  by  BUSEN*  and  the  di- 
rection is  controlled  by  BUSDIR* 

4.2.4  System  Timing 

The  main  timing  reference  of  the  microcomputer,  with  the 
exception  of  the  FDC  circuit,  is  generated  by  a  Gate  Array 
U148  and  a  20  2752  MHz  Crystal  This  reference  is  inter- 
nally divided  in  the  Gate  Array  to  generate  all  necessary  tim- 
ing for  the  CPU,  video  circuit,  and  RS-232-C  circuit  The 
CPU  clock  is  generated  U148  which  can  be  either  2  or 
4MHz  depending  on  the  logic  state  of  FAST  input  (pin  6  of 
U148)  if  FAST  is  a  logic  low,  the  U148  generates  a  2  02752 
MHz  clock  If  FAST  is  a  logic  high,  U148  generates  a 
4  05504  MHz  signal  PCLK  (pin  23  of  U148)  is  filtered 
through  a  ferrite  bead  (FB2)  and  22H  Resistor  (R9)  and  then 


fed  to  the  CPU  U45  PCLK  is  generated  as  a  symmetrical 
clock  and  is  never  allowed  to  be  short  cycled  (eg )  Not  al- 
lowed to  generate  a  low  or  high  pulse  under  110 
nanoseconds 

4.2.4.1  Video  Timing 

The  video  timing  is  also  generated  by  U148  with  the  help  of  a 
PLL  Multiplier  Module  (PMM)  U 1 46  These  two  ICs  generate  all 
the  necessary  timing  signals  for  the  four  video  modes:  64  x  1 6, 
32  x  1 6, 80  x  24,  and  40  x  24  Two  reference  clocks  are  required 
for  the  four  video  modes  One  reference  clock  is  1 0  1 376  MHz 
It  is  generated  internally  to  U1 48,  and  is  used  by  the  64  x  1 6  and 
32  x  16  modes  The  second  reference  clock  is  a  12  672  MHz 
(12M)  clock  which  is  generated  by  the  PMM  U146  12M  clock 
is  used  by  the  80  x  24  and  40  x  24  modes  A  1  2672  MHz 
(1  2M16)  signal  is  output  from  pin  3  of  U1 48  and  is  generated 
from  the  master  reference  clock,  the  20  2752  MHz  crystal 
1  2M 1 6  is  used  for  a  reference  clock  for  the  PMM  The  PMM  is 
internally  set  to  oscillate  at  1 2  672  MHz  which  is  output  as  1 2M 
U148  divides  12M  by  10  to  generate  a  second  1  2672  MHz 
clock  (1  2M10)  which  is  fed  into  pin  5  of  U 146  (PMM)  The  two 
1  2672  MHz  signals  are  internally  compared  in  the  PMM  where 
it  corrects  the  1 2  672  MHz  output  so  it  is  synchronized  with  the 
20.2752  MHz  clock 

MODSEL  and  8064"  signals  are  used  to  select  the  desired 
video  mode  8064"  controls  which  reference  clock  is  used  by 
U127  and  MODSEL  controls  the  single  or  double  character 
width  mode  Refer  to  the  following  chart  for  selecting  each 
video  mode 


8064* 

MODSEL 

Video  Moc 

0 

0 

64x16 

0 

1 

32x16 

1 
1 

0 
1 

80x24 
40x24 

'This  is  the  state  to  be  written  to  latch  U85  Signal  is  inverted 
before  being  input  to  U148 
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DCLK,  the  reference  clock  selected,  is  output  from  U148 
U148  generates  SHIFT*,  XADR7*,  CRTCLK,  LOADS',  and 
LOAD"  (or  proper  timing  for  the  four  video  modes,  U149  also 
generated  H,  I,  and  J  which  are  fed  to  the  Graphics  Port  J7 
for  reference  timings  of  Hires  graphics  video  Refer  to  Video 
Timing,  Figs  4-2  and  4-3  for  timing  reference 

4.2.5  Address  Decode 

The  Address  Decode  section  will  be  divided  into  two  subsec- 
tions: Memory  Map  decoding  and  Port  Map  decoding 

4.2.5.1  Memory  Map  Decoding 

Memory  Map  Decoding  is  accomplished  by  Gate  Array  4  2 
(U106)  Four  memory  map  modes  are  available  which  are  com- 
patible with  the  Model  III  and  Model  4  microcomputers  U106  is 
used  for  memory  map  control  which  also  controls  page  map- 
ping of  the  32K  RAM  pages  Refer  to  Memory  Maps  below 

4.2.5.2  Port  Map  Decoding 

Port  Map  Decoding  is  accomplished  by  Gate  Array  4  2  (U106) 
U106  decodes  the  low  order  address  (A0-A7)  from  the  CPU 
and  decodes  the  port  being  selected  The  IN*  signal  allows  the 
CPU  to  read  from  a  selected  port  and  the  OUT*  signal  allows 
the  CPU  to  write  to  the  selected  port  Refer  to  IO  Port 
Assignment 

4.2.6  ROM 

The  Model  4P  contains  only  a  4K  x  8  Boot  ROM  (U70).  This 
ROM  is  used  only  to  boot  up  a  Disk  Operating  System  into 
the  RAM  memory  If  Model  III  operation  or  DOS  is  required, 
then  the  RAM  from  location  0000-37FFH  must  be  loaded 
with  an  image  of  the  Mode!  Ill  or  4  ROM  code  and  then  exe- 
cuted. A  file  called  MODEL  A/Ill  is  supplied  with  the  Model 
4P  which  contains  the  ROM  image  for  proper  Model  III  oper- 
ation. On  power-up,  the  Boot  ROM  is  selected  and  mapped 
into  location  0000-OFFFH  After  the  Boot  Sector  or  the  ROM 
Image  is  loaded,  the  Boot  ROM  must  be  mapped  out  by 
OUTing  to  port  9CH  with  DO  set  or  by  selecting  Memory 
Map  modes  2  or  3  In  Mode  1  the  RAM  is  write  enabled  for 
the  full  14K-  This  allows  the  RAM  area  mapped  where  Boot 
ROM  is  located  to  be  written  to  while  executing  out  of  the 
Boot  ROM.  Refer  to  Memory  Maps 

The  Model  4P  Boot  ROM  contains  all  the  code  necessary  to 
initialize  hardware,  detect  options  selected  from  the  keyboard, 
read  a  sector  from  a  hard  disk  or  floppy,  and  load  a  copy  of  the 
Model  HI  ROM  image  {as  mentioned)  into  the  lower  14K  of 
RAM 


The  firmware  is  divided  into  the  following  roulines; 


Hardware  Initialization 

Keyboard  Scanner 

Control 

Floppy  and  Harcf  Disk  Driver 

Disk  Directory  Searcher 

File  Loader 

Error  Handler  and  Displayer 

RS-232  Boot 

Diagnostic  Package 


Theory  of  Operation 

This  section  describes  the  operation  of  various  routines  in  the 
ROM  Normally,  the  ROM  is  not  addressable  by  normal  use 
However,  there  are  several  routines  that  are  available  through 
fixed  calling  locations  and  these  may  be  used  by  operating  sys- 
tems that  are  booting 

On  a  power-up  or  RESET  condition,  the  Z80  s  program  counter 
is  set  to  address  0  and  the  boot  ROM  is  switched-in  The  mem* 
ory  map  of  the  system  is  set  to  Mode  0  (See  Memory  Map  for 
details  )  This  will  cause  the  Z80  to  fetch  instructions  from  the 
boot  ROM 

The  Initialization  section  of  the  Boot  ROM  now  performs  Ihese 
functions: 


Disables  maskable  and  non-maskable  interrupts 

Interrupt  mode  1  is  selected 

Programs  the  CRT  Controller 

Initializes  the  boot  ROM  control  areas  in  RAM 

Sets  up  a  stack  pointer 

Issues  a  Force  Interrupt  to  the  Floppy  Disk  Controller 

to  abort  any  current  activity 

Sets  the  system  clock  to  4mhz 

Sets  the  screen  to  64  x  16 

Disables  reverse  video  and  the  alternate  character 

sets 

Tests  for  <    >  key  being  pressed" 

Clears  all  2K  of  video  memory 


*  This  is  a  special  test  If  the  <  >  is  being  pressed,  then 
control  is  transferred  to  the  diagnostic  package  in  the 
ROM  All  other  keys  are  scanned  via  Ihe  Keyboard 
Scanner 
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The  Keyboard  scanner  is  now  called  It  scans  She  keyboard  for 
a  set  period  of  time  and  returns  several  parameters  based  on 
which,  if  any,  keys  were  pressed 

The  keyboard  scanner  checks  for  several  different  groups  of 
keys  These  are  shown  below: 


Function  Group 

<F1> 

Selection  Group 

A 

<F2> 

B 

<F3> 

C 

<1> 

D 

<2> 

E 

<3> 

F 

<Left-Shift> 

G 

<Right-Shift> 
<Ctrl> 

<Caps> 

Special  Keys 
<P> 

Misc  Keys 

<  Enter  > 

<L> 

<  Break  > 

When  any  key  in  the  Function  Group  is  pressed,  it  is  recorded 
in  RAM  and  will  be  used  by  the  Control  routine  in  directing  the 
action  of  the  boot  If  more  than  one  of  these  keys  are  pressed 
during  the  keyboard  scan,  the  last  one  detected  will  be  the  one 
that  is  used  The  Function  group  keys  are  currently  defined  as: 


<F1>  or  <1> 

<F2>  or  <2> 

<F3>  or  <3> 

<Left-Shift> 

<Right-Shift> 

<Ctri> 

<Caps> 


Will  cause  hard  disk  boot 
Will  cause  floppy  disk  boo! 
Will  force  Model  III  mode 
Reserved  for  future  use 
Boot  from  RS-232  port 
Reserved  for  future  use 
Reserved  for  future  use 


<L>  Instructs  the  Control  routine  to 

load  the  Model  III  ROM-image 
even  if  it  is  already  loaded  This 
is  useful  if  the  ROM-image  has 
been  corrupted  or  when  switch- 
ing ROM-images  (Note  that 
this  will  not  cause  the  ROM- 
image  to  be  loaded  if  the  boot 
sector  check  indicates  that  the 
Mode!  Ill  ROM  image  is  not 
needed  Press  <F3>  or  <F3  • 
and  <L>  to  accomplish  that 

The  Selection  group  keys  are  used  in  determining  which  fife  will 
be  read  from  disk  when  the  ROM-image  is  loaded  For  details 
of  this  operation,  see  the  Disk  Directory  Searcher  If  more  than 
one  of  the  Selection  group  keys  are  pressed,  the  last  one  de- 
tected will  be  the  one  that  is  used 


The  Miscellaneous  keys  are: 


<  Break  > 


Pressing  this  key  is  simply  re- 
corded by  setting  location 
405BH  non-zero  It  is  up  to  an 
operating  system  to  use  this 
flag  if  desired 

Terminates  the  Keyboard  rou- 
tine Any  other  keys  pressed  up 
to  that  time  will  be  acted  upon 
<Enter>  is  useful  for  experi- 
enced users  who  do  not  want  to 
wait  until  the  keyboard  limer 
expires 


The  Control  section  now  takes  over  and  follows  the  following 
flowchart 


The  Special  keys  are  commands  to  the  Control  routine  which 
direct  handling  of  the  Model  III  ROM-image.  Each  key  is  de- 
tected individually. 


<P> 


When  loading  the  Model  HI 
ROM-image,  the  user  will  be 
prompted  when  the  disks  can 
be  switched  or  when  ROM 
BASIC  can  be  entered  by 
pressing  <Break> 
Instructs  the  Control  routine  to 
not  load  the  Model  HI  ROM- 
image,  even  if  it  appears  that 
the  operating  system  being 
booted  requires  it 
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At  this  point,  no  valid  Function  keys 
have  been  pressed. 
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Packages  that  do  not  reference  the  Model  III  ROM  in  the 
boot  sector  can  still  cause  the  Model  III  ROM  image  to  be 
loaded  by  coding  a  CDxxOO  somewhere  in  the  boot  sector 
It  does  not  have  to  be  executable  At  the  same  time.  Model 
4  packages  must  take  care  that  there  is  no  sequence  of 
bytes  in  the  boot  sector  that  could  be  mis-interpreted  to  be 
a  reference  to  the  Boot  ROM  An  example  of  this  would  be 
sequence  06CD0E00.  which  is  a  LD  B.OCDH  and  a  ID 
CO  If  the  boot  sector  cannot  be  changed,  then  the  user 
must  press  the  <F3>  key  each  time  the  system  is  started 
to  inform  the  ROM  that  the  disk  contains  a  Model  III  pack- 
age which  needs  the  Model  III  ROM  image 

(2)  if  you  are  loading  a  Model  4  operating  system,  then  the 
boot  ROM  will  always  transfer  control  to  the  first  byte  of  the 
boot  sector  which  is  at  4300H  If  you  are  loading  a  Model 
III  operating  system  or  about  to  use  Model  HI  ROM  BASIC, 
then  the  transfer  address  is  301 5H  This  is  the  address  of 
a  jump  vector  in  the  C  ROM  of  the  Model  111  ROM  image 
and  this  will  cause  the  system  to  behave  exactly  like  a 
Model  HI  If  the  ROM  image  file  that  is  loaded  has  a  differ- 
ent transfer  address  then  that  address  will  be  used  when 
loading  is  complete  if  the  image  is  already  present,  the 
Boot  ROM  will  use  301 5H 

(3)  Two  different  tests  are  done  to  insure  that  the  Model  Hi 
ROM  image  is  present  The  first  test  is  to  check  every  third 
location  starting  at  3000H  for  a  C3H  This  is  done  for  1 0  lo- 
cations If  any  of  these  locations  does  not  contain  a  C3H. 
then  the  ROM  image  is  considered  to  be  not  present 
The  next  test  is  to  check  two  bytes  at  location  OOOBH  If 
these  addresses  contain  E9E1H.  then  the  ROM  image  is 
considered  to  be   present 

(4)  See  Disk  Director  Searcher  for  more  information 


(1 )  If  the  boot  sector  was  not  256  bytes  in  length,  then  it  is  as- 
sumed to  be  a  Model  III  package,  and  the  ROM  image  will 
be  needed  If  the  sector  is  256  bytes  in  length,  then  the 
sector  is  scanned  for  the  sequence  CDxxOOH  The  CD  is 
the  first  byte  of  a  Z80  unconditional  subroutine  call  The 
next  byte  can  have  any  value  The  third  byte  is  tested 
against  a  zero  What  this  check  does  is  test  for  any  refer- 
ences to  the  first  256  bytes  of  memory  All  Radio  Shack 
Model  III  operating  systems,  and  many  other  packages  all 
reference  the  ROM  at  some  point  during  the  boot  sector 
Most  boot  sectors  will  display  a  message  if  the  system  can- 
not be  loaded  To  save  space,  these  routines  use  the 
Model  ill  ROM  calls  to  display  the  message  Several  ROM 
calls  have  their  entry  points  in  the  first  256  bytes  of  mem- 
ory, and  these  references  are  detected  by  the  boot  ROM 


(5)  See  File  Loader  for  more  information 

(6)  The  RS-232  loader  is  described  under  RS-232  Boot 

Disk  Directory  Searcher 

When  the  Model  II!  ROM  image  is  to  be  loaded  it  is  always  read 
from  the  floppy  in  drive  0 

Before  the  operation  begins,  some  checks  are  made  First,  the 
boot  sector  is  read  in  from  the  floppy  and  the  first  byte  is 
checked  to  make  sure  it  is  either  a  00H  or  a  FEH  If  the  byte 
contains  some  other  value,  no  attempt  will  be  made  to  read  the 
ROM  image  from  that  disk  The  location  of  the  directory  cylinder 
is  then  taken  from  the  boot  sector  and  the  type  of  disk  is  deter- 
mined This  is  done  by  examining  the  Data  Address  Mark  that 
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was  picked  up  by  the  Floppy  Disk  Controller  (FDC)  during  the 
read  of  the  sector  If  the  DAM  equals  1 .  the  disk  is  a  TRSDOS 
1  x  style  disk  If  the  DAM  equals  0.  then  the  disk  is  a  LDOS  5  1/ 
TRSDOS  6  style  disk  This  is  important  since  TRSDOS  1  x 
disks  number  sectors  starting  with  1  and  LDOS  style  disks 
number  sectors  starting  with  0 

Once  the  disk  type  has  been  determined,  an  extra  test  is  made 
if  the  disk  is  a  LDOS  style  disk  This  test  reads  the  Granule  Al- 
location Table  (GAT)  to  determine  if  the  disk  is  single  sided  or 
double  sided 

The  directory  is  then  read  one  record  at  a  time  and  a  compare 
is  made  against  the  pattern  MODEL%  for  the  filename  and 
'III'  for  the  extension  The  '%'  means  that  any  character  will 
match  this  position  If  the  user  pressed  one  of  the  selection 
keys  (A-G)  during  the  keyboard  scan,  then  that  character  is 
substituted  in  place  of  the  "%"  character  For  example,  if  you 
pressed  "D",  then  the  search  would  be  for  the  file  MODELD 
with  the  extension  III'  The  searching  algorithm  searches  until 
it  finds  the  entry  or  i!  reaches  the  end  of  the  directory 

Once  the  entry  has  been  found,  the  extent  information  for  that 
file  is  copied  into  a  control  block  for  later  use 

File  Loader 

The  file  loader  is  actually  two  modules  —  the  actual  loader  and 
a  set  of  routines  to  fetch  bytes  from  the  file  on  disk  The  loader 
is  invoked  via  a  RST  28H  The  byte  fetcher  is  called  by  the 
loader  using  RST  20H  Since  restart  vectors  can  be  re-directed, 
the  same  loader  is  used  by  the  RS-232  boot  The  difference  is 
that  the  RST  20H  is  redirected  to  point  to  the  RS-232  data  re- 
ceiving routine  The  loader  reads  standard  loader  records  and 
acts  upon  two  types: 

01  Data  Load 

1  byte  with  length  of  block,  including  address 

1  word  with  address  to  load  the  data 

n  bytes  of  dala,  where  n  +  2  equals  the  length  specified 

02  Transfer  Address 

1  byte  with  the  value  of  02 

1  word  with  the  address  to  start  execution  at 

Any  other  loader  code  is  treated  as  a  comment  block  and  is  ig- 
nored Once  an  02  record  has  been  found,  the  loader  stops 
reading,  even  if  there  is  additional  data,  so  be  sure  to  place  the 
02  record  at  the  end  of  the  file 


Floppy  and  Hard  Disk  Driver 

The  disk  drivers  are  enlered  via  RST  8H  and  will  read  a  sector 
anywhere  on  a  floppy  disk  and  anywhere  on  head  1  (top-head) 
in  a  hard  disk  drive  Either  256  or  51 2  byte  sectors  are  readable 
by  these  routines  and  they  make  the  determination  of  the  sector 
size  The  hard  disk  driver  is  compatible  with  both  the  WD1000 
and  the  WD1 01 0  controllers  The  floppy  disk  driver  is  written  for 
the  WD1 793  controller 

Serial  Loader 

Invoking  the  serial  loader  is  similar  to  forcing  a  boot  from  hard 
disk  or  floppy  In  this  case  the  right  shift  key  must  be  pressed  at 
some  time  during  the  first  three  seconds  after  reset  The  pro- 
gram does  not  care  if  the  key  is  pressed  forever,  making  it  con- 
venient to  connect  pins  8  and  1 0  of  the  keyboard  connector  with 
a  shorting  plug  for  bench  testing  of  boards  This  assumes  that 
the  object  program  being  loaded  does  not  care  about  the  key 
closure 

Upon  entry,  the  program  first  asserts  DTR  (J4  pin  20)  and  RTS 
(J4  pin  4)  true  Next,  Not  Ready"  is  printed  on  the  topmost  line 
of  the  video  display.  Modem  status  line  CD  (J4  pin  8)  is  then 
sampled  The  program  loops  until  it  finds  CD  asserted  true  At 
that  time  the  message  Ready1'  is  displayed  Then  the  program 
sets  about  determining  the  baud  rate  from  the  host  computer 

To  determine  the  baud  rate,  the  program  compares  data  re- 
ceived by  the  UART  to  a  lest  byte  equal  to  '55'  hex  The  receiver 
is  first  set  to  1 9200  baud  If  ten  bytes  are  received  which  are  not 
equal  to  the  test  byte,  the  baud  rate  is  reduced  This  sequence 
is  repeated  until  a  valid  test  byte  is  received  If  ten  failures  occur 
at  50  baud,  the  entire  process  begins  again  at  19200  baud  If  a 
valid  test  byte  is  received,  the  program  waits  for  ten  more  to  ar- 
rive before  concluding  that  it  has  determined  the  correct  baud 
rate  If  at  this  time  an  improper  byte  is  received  or  a  receiver  er- 
ror (overrun,  framing,  or  parity)  is  intercepted,  the  task  begins 
again  at  19200  baud 

In  order  to  get  to  this  point,  the  host  or  the  modem  must  assert 
CD  true  The  host  must  transmit  a  sequence  of  test  bytes  equal 
lo  '55'  hex  with  8  data  bits,  odd  parity,  and  1  or  2  stop  bits  The 
test  bytes  should  be  separated  by  approximately  0  1  second  to 
avoid  overrun  errors 

When  the  program  has  determined  the  baud  rate,  the  message: 

Found  Baud  Rate  x" 


is  displayed  on  the  screen,  where  "x"  is  a  letter  from  A  to  P. 
meaning: 


A  =  50  baud  E  -  1 50 

B  =  75  F  =  300 

C  =  110  G  =  600 

D  -  134  5  H  -  1200 


I  =  1800  M  =  4800 

J  =  2000  N  =  7200 

K  =  2400  O  =  9600 

L  =  3600  P  =  19200 
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The  same  message  less  the  character  signifying  the  baud  rate 
is  transmitted  to  the  host,  with  the  same  baud  rate  and  protocol 
This  message  is  the  signal  to  the  host  to  stop  transmitting  test 
bytes 

Alter  the  program  has  transmitted  the  baud  rate  message,  it 
reads  from  the  UART  data  register  in  order  to  clear  any  overrun 
error  that  may  have  occurred  due  to  the  test  bytes  coming  in 
during  the  transmission  of  the  message  This  is  because  the  re- 
ceiver must  he  marie  ready  to  receive  a  sync  byte  signalling  the 
beginning  of  the  command  file  For  this  reason,  it  is  important 
that  the  host  wait  until  the  entire  baud  rate  message  (16  char- 
acters) is  received  before  transmitting  the  sync  byte,  which  is 
equal  to  FF  hex 

When  the  loader  receives  the  sync  byte,  the  message: 

Loading 

is  displayed  on  the  screen  Again  the  same  message  is  trans- 
mitted to  the  host.  and.  again,  the  host  must  wait  for  the  entire 
transmission  before  starting  into  the  command  file 

II  the  receiver  should  intercept  a  receive  error  while  waiting  for 
the  sync  byte,  the  entire  operation  up  to  this  point  is  aborted 
The  video  display  is  cleared  and  the  message: 

Error,  x 

is  displayed  near  the  bottom  of  the  screen,  where  x  is  a  letter 
from  B  to  H,  meaning: 

B  =  parity  error 

C  =  framing  error 

D  -  parity  &  framing  errors 

E  =  overrun  error 

F  -  parity  &  overrun  errors 

G  =  framing  &  overrun  errors 

H  =  parity  &  framing  &  overrun  errors 

The  message: 

■"Error 

is  then  transmitted  to  the  host  The  entire  process  is  then  re- 
peated from  the  'Not  Ready '  message  A  six  second  delay  is 
inserted  before  reinitialization  This  is  longer  than  the  time  re- 
quired to  transmit  five  bytes  at  50  baud,  so  there  is  no  need  to 
be  extra  careful  here 

if  the  sync  byte  is  received  without  error,  then  the  'Loading 
message  is  transmitted  and  the  program  is  ready  to  receive  the 
command  file.  After  receiving  the  -Loading  message  the  host 
can  transmit  the  file  without  nulls  or  delays  between  bytes 


(Since  the  file  represents  Z80  machine  code  and  all  256 
combinations  are  meaningful,  it  would  be  disastrous  to 
transmit  nulls  or  other  ASCII  control  codes  as  fillers,  ac- 
knowledgement, or  start-stop  bytes  The  only  control 
codes  needed  are  the  standard  command  file  control 
bytes ) 

Data  can  be  transmitted  to  the  loader  at  1 9200  baud  with  no  de- 
lays inserted  Two  stop  bits  are  recommended  at  high  baud 
rates 

See  the  File  Loader  description  for  more  information  on  file 
loading 

If  a  receive  error  should  occur  during  file  loading,  the  abort  pro- 
cedure described  above  will  take  place,  so  when  attempting  re- 
mote control,  it  is  wise  to  monitor  the  host  receiver  during 
transmission  of  the  file  When  the  host  is  near  the  object  board, 
as  is  the  case  in  the  factory  application,  or  when  more  than  one 
board  is  being  loaded,  it  may  be  advantageous  or  even  nec- 
essary to  ignore  the  transmitted  responses  of  the  object 
board(s)  and  to  manually  pace  the  test  byte,  sync  byte,  and 

video  display  for  handshaking 

System  Programmers  Information 

The  Model  4P  Boo!  ROM  uses  two  areas  of  RAM  while  it  is  run- 
ning These  are  4000H  to  40FFH  and  4300H  to  43FFH  (For 
512  byte  boot  sectors,  the  second  area  is  4300H  to  44FFH  )  If 
the  Model  III  ROM  image  is  loaded,  additional  areas  are  used 
See  the  technical  reference  manual  for  the  system  you  are  us- 
ing for  a  list  of  these  areas 

Operating  systems  that  want  to  support  a  software  restart  by  re- 
executing  the  contents  of  the  boot  ROM  can  accomplish  this  in 
one  of  two  ways  If  the  operating  system  relies  on  the  Model  III 
ROM  image,  then  jump  to  location  0  as  you  have  in  the  past  if 
the  operating  system  is  a  Model  4  mode  package,  a  simple  way 
is  to  code  the  following  instructions  in  your  assembly  and  load 
them  before  you  want  to  reset: 

Absolute  Location  Instruction 

0000  Dl 

0001  ID  A,1 
0003  OUT            (9CH).A 

These  instructions  cause  the  boot  ROM  to  become  address- 
able After  executing  the  OUT  instruction,  the  next  instruction 
executed  will  be  one  in  the  boot  ROM  (These  instructions  also 
exist  in  the  Model  III  ROM  image  at  location  0  }  The  boot  ROM 
has  been  written  so  that  the  first  instruction  is  at  address  0005 
The  hardware  must  be  in  memory  mode  0  or  1 ,  or  else  the 
boot  ROM  will  not  be  switched  in,  This  operation  can  be 
done  with  an  OUT  instruction  and  then  a  RST  0  can  be  exe- 
cuted to  have  the  ROM  switched  in 
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Restarts  can  be  redirected  at  any  time  while  the  ROM  is 
switched  in  Alt  restarts  jump  to  fixed  locations  in  RAM  and 
these  areas  may  be  changed  to  point  to  the  routine  that  is  to  be 
executed 

Restart    RAM  Location     Default  Use 

Cold  Start/Boot 

Disk  I/O  Request 

Display  string 

Display  biock 

Byte  Fetch  {Called  by  Loader} 

File  Loader 

Keyboard  scanner 

Reserved  for  future  use 

NMI  {Floppy  I/O  Command 

Complete) 


Display  String  (RST1  OH) 


0 

none 

8 

4000H 

10 

4003H 

18 

4006H 

20 

4009H 

28 

400CH 

30 

400FH 

38 

401 2H 

66 

401 5H 

Accepts 
HL 


Returns 
Success  Always 

A 

DE 

HL 


Pointer  to  text  to  be  displayed 
Text  must  be  terminated  with  a  null  (0) 
Offset  position  on  screen  where  text  is  to 
be  displayed 

(A  0000H  will  be  the  upper  lef!-hand  cor- 
ner of  the  display  ) 


Altered 

Points  to  next  position  on  video 

Points  to  the  null  (0) 


Display  Block  (RST18H) 


The  above  routines  have  fixed  entry  parameters  These  are  de- 
scribed here 

Disk  I/O  Request  (RST  8H) 


Accepts 


DE 
HL 


Returns 
Z 
NZ 

Error  Codes 
3 
4 

5 


11 
12 


1  for  floppy,  2  for  hard  disk 
Command 
initialize        1 
Restore        4 
Seek  6 

Read  12  (AN  reads  have  an  im- 

plied seek) 
Sector  number  to  read 
The  contents  of  the  location  disktype 
(405CH)  are  added  to  this  value  before 
an  actual  read  If  the  disk  is  a  two  sided 
floppy,  just  add  18  to  the  sector  number 
Cylinder  number    (Only  E  is  used  in 
floppy  operations) 

Address  where  data  from  a  read  opera- 
tion is  to  be  stored 


Success,  Operation  Completed 
Error,  Error  code  in  A 


Hard  Disk  drive  is  not  ready 

Floppy  disk  drive  is  not  ready 

Hard  Disk  drive  is  not  available 

Floppy  disk  drive  is  not  available 

Drive  Not  Ready  and  no  Index  (Disk  in 

drive,  door  open) 

CRC  Error 

Seek  Error 

Lost  Data 

ID  Not  Found 


Accepts 

HL  Points  to  control  vector  in  the  format: 

+  0        Screen  Offset 
+  2        Pointer  to  text,  terminated  with 
null 

+  4        Pointer  to  text,  terminated  with 
null 

+  n        word  FFFFH        End  of  control 
vector 
or  +n        word  FFFEH        Next  word  is 

new  Screen 
Offset 
If  Z  flag  is  set  on  entry,  then  the  first  screen  offset  is  read  from 
DE  instead  of  from  the  control  vector 

Each  string  is  positioned  after  the  previous  string,  unless  a 
FFFEH  entry  is  found  This  is  used  heavily  in  the  ROM  to  re- 
duce duplication  of  words  in  error  messages 

Returns 
Success  Always 

DE  Points  to  next  position  on  video 

Byte  Fetch  (RST  20H) 


Accepts  None 
Returns 

Z 

NZ 


Errors 


2 
10 


Success,  byte  in  A 
Failure,  error  code  in  A 


Any  errors  from  the  disk  I/O  call  and: 

ROM  image  can"t  be  loaded  —  Too  many 

extents 

ROM  Image  can't  be  loaded  —  Disk  drive 

is  not  ready 
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File  Loader  (RST  28H) 

Accepts  None 


Returns 
2 
NZ 

Errors 


Success 

Failure,  error  code  in  A 


Any  errors  from  the  disk  I/O  call  or  the 
byte  fetch  call  and: 
0  The  ROM  image  was  not  found  on  drive  0 

There  are  several  pieces  of  information  left  in  memory  by  the 
boot  ROM  which  are  useful  to  system  programmers  These  are 
shown  below: 


RAM  Location 

401 DH 


4056H 
4057H 


4059H 


405BH 


Description 

ROM  Image  Selected  (%  for  none 
selected  or  A-G} 
Boot  type 

1  -  Fioopy 

2  =  Hard  disk 

3  -  ARCNET 

4  -  RS-232C 

5  -  7  =  Reserved 

Boot  Sector  Size  (1  for  256,  2  for  512) 

RS-232  Baud  Rate  (only  valid  on  RS- 

232  boot) 

Function  Key  Selected 

0  =  No  function  key  selected 


<F1>  or  <1> 

86 

<F2>  or<2> 

87 

<F3>or  <3> 

88 

<Caps> 

85 

<Ctrl> 

84 

<Left-Shift> 

82 

<Right-Shift> 

83 

Reserved 

80-81  and  89-90 

Break  Key  Indication  (non-zero  if 

<Break>  pressed) 

Disk  type 

(0  for  LDOS/ 

TRSDOS6,1  (or 

TRSDOS  1  x) 

The  DRAMs  require  multiplexed  incoming  address  lines  This 
is  accomplished  by  ICs  U110  and  U111  which  are  74LS157 
multiplexers  Daia  to  and  from  the  DRAMs  are  buffered  by  a 
74LS245  (U1 1 8)  which  is  controlled  by  Gate  Array  4  2  (U1 06) 
The  proper  timing  signals  RASO*.  RAS1* .  MUX*,  and  CAS*  are 
generated  by  a  delay  line  circuit  U94 .  U1 16  (1/2  of  a  74S1 12} 
and  U117  (1/4  of  a  74F08)  are  used  to  generate  a  precharge 
circuit  During  M1  cycles  of  the  Z80A  in  4  MHz  mode,  the  high 
time  in  MREQ  has  a  minimum  time  of  1 1 0  nanosecs  The  spec- 
ification of  6665  DRAM  requires  a  minimum  of  1 20  nanosecs  so 
this  circuit  will  shorten  the  MREQ  signal  during  the  M1  cycle 
The  resulting  signal  PMREQ  is  used  to  start  a  RAM  memory 
cycle  through  U 1 1 4  (a  74S64)  Each  different  cycle  is  controlled 
at  U114  to  maintain  a  fast  M1  cycle  so  no  wait  states  are  re- 
quired The  output  of  U114  (PRAS*)  is  ANDed  with  RFSH  to  not 
allow  MUX*  and  CAS*  to  be  generated  during  a  REFRESH 
cycle  PRAS*  also  generates  either  RASO*  or  RAS1  * .  depend- 
ing on  which  bank  of  RAM  the  CPU  is  selecting  GCAS*  gen- 
erated by  the  delay  Sine  U94  is  latched  by  U116  (1/2  of  a 
74S1 1 2)  and  held  to  the  end  of  the  memory  cycle  The  output 
of  U1 1 6  is  ANDed  with  VIDEO  signal  to  disable  the  CAS*  signal 
from  occurring  if  the  cycle  is  a  video  memory  access  Refer  to 
M1  Cycle  Timing  (Figure  4-7  and  4-8),  Memory  Read  and 
Memory  Write  Cycle  Timing  (Figure  4-9)  and  (Figure  4-10) 


Keep  in  mind  that  Model  til  ROM  image  will  initialize  these 
areas,  so  this  information  is  useful  only  to  the  Mode!  4  mode 
programmer 

4.2.7  RAM 

Two  configurations  of  Random  Access  Memory  (RAM)  are 
available  on  the  Model  4P:  64K  and  128K.  The  64K  and  128K 
option  use  the  6665-type  64K  x  1  200NS  Dynamic  RAM,  which 
requires  only  a  single  +  5v  supply  voltage 
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Memory  Map  —  Model  4P 


ModeO 

SELO 
SEL1 
ROM 

.,0    -  OV 
-  0    =  OV 

=  1   =  ov 

Mode  1 

SELO    -  1    -    +5V 
SEL1    -  0    -  OV 
ROM    =0    =   +  5V 

0000  —  OFFF 

Boot  ROM 

4K 

0000  — 

37FF 

RAM 

14K 

1000  —  37FF 

RAM  {Read  Only} 

10K 

3800  — 

3BFF 

Keyboard 

1K 

37E8  — 37E9 

Printer  Status  (Read  Only) 

2 

3C00- 

-3FFF 

Video 

1K 

3800  — 3BFF 

Keyboard 

1K 

4000  — 

FFFF 

RAM 

48K 

3CO0  —  3FFF 

Video 

1K 

4000  — FFFF 

RAM 

48K 

Mode  2 

SELO    -  0    =  OV 
SEL1    -  1    =   +5V 

ModeO 

SELO 
SEL1 

-  0   =  OV 

-  0   -  OV 

ROM    -  X   -  Don  t  Care 

ROM 

=  0    =   +  5V 

0000  — 

F3FF 

RAM 

61K 

F400- 

F7FF 

Keyboard 

1K 

0000  —  37FF 

RAM  (Readonly) 

14K 

F800~~ 

FFFF 

Video 

2K 

37E8  —  37E9 

Printer  Status  (Read  Only) 

2 

3800  — 38FF 

Keyboard 

1K 

3UUU  —  3hf~i~ 

viaeo 

iK 

ivioae  3 

SELO    ~-    i    =    ■>-  d'v 

4000  —  FFFF 

RAM 

48K 

SEL1    =  1    -   +5V 
ROM    =  X  =  Don't  Care 

Mode  1 

SELO 
SEL1 
ROM 

=  1    =   +5V 
=  0    -  OV 
-  1    -  ov 

0000- 

FFFF 

RAM 

64  K 

0000  — OFFF 

Boot  ROM 

4K 

0000  — OFFF 

RAM  (Write  Only) 

4K 

1000  — 37FF 

RAM 

10K 

3800  — 3BFF 

Keyboard 

1K 

3C00  — 3FFF 

Video 

1K 

4000  — FFFF 

RAM 

48K 
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I/O  Port  Assignment 


Normal!; 

/ 

Port# 

Used 

Out 

in 

FC- 

_FF 

FF 

CASSOUT  * 

MODIN  * 

F8- 

~FB 

F8 

LPOUT  " 

LPIN* 

F4- 

-F7 

F4 

DRVSEL  * 

(RESERVED) 

F0~ 

-F3 

_ 

DISKOUT  * 

DISKiN  * 

FO 

FO 

FDC  COMMAND  REG 

FDC  STATUS  REG 

F1 

F1 

FDC  TRACK  REG 

FDC  TRACK  REG 

F2 

F2 

FDC  SECTOR  REG 

FDC  SECTOR  REG 

F3 

F3 

FDC  DATA  REG 

FDC  DATA  REG 

EC' 

—  EF 

EC 

MODOUT  * 

RTCSN  ' 

E8- 

-EB 

_ 

RS2320UT  * 

RS232IN  * 

E8 

E8 

UART  MASTER  RESET 

MODEM  STATUS 

E9 

E9 

BAUD  RATE  GEN  REG 

(RESERVED) 

EA 

EA 

UART  CONTROL  AND 
MODEM  CONTROL  REG 

UART  STATUS  REG 

EB 

EB 

UART  TRANSMIT 
HOLDING  REG 

UART  HOLDING  REG 
(RESET  D  R ) 

E4- 

-E7 

E4 

WRNMI  MASK  REG  * 

hD  NMI  STATUS  ' 

E0~ 

-E3 

EO 

WR  INT  MASK  REG   * 

RDSNT  MASK  REG  ' 

A0- 

~DF 

_ 

(RESERVED) 

(RESERVED) 

9C- 

-9F 

9C 

BOOT' 

(RESERVED) 

94- 

-9B 

_ 

(RESERVED) 

(RESERVED) 

90- 

-93 

90 

SEN* 

(RESERVED) 

sc- 

~8F 

_ 

GSELO  * 

GSELO  * 

ss- 

-8B 

_ 

CRTCCS  * 

(RESERVED) 

eaj 

3A 

88 

CRCTADD  REG 

(RESERVED) 

89,  f 

3B 

89 

CRCT  DATA  REG 

(RESERVED) 

84- 

-87 

84 

OPREG  ' 

(RESERVED) 

80- 

-83 

_ 

GSEL1  * 

GSEL1  ■ 

Hardware  125 


I/O  Port  Description 

Name:  CASSOUT * 

Port  Address:   FC— FF 
Access:  WRITE  ONLY 

Description:      Output  data  (o  cassette  or  for  sound 
generation 

Note:      The  Model  4P  does  not  support  cassette  storage, 
this  port  is  only  used  to  generate  sound  that  was  to 
be  output  via  cassette  port  The  Model  4P  sends 
data  to  onboard  sound  circuit 

DO  -  Cassette  output  level  (sound  data  output) 

D1  =  Reserved 

D2— D7      =  Undefined 


Name:  MODIN  *  (CASSIN  *) 

Port  Address:  FC  — FF 
Access:  READONLY 

Description:      Configuration  Status 


DO 

=  0 

D1 

=  CASSMOTORON  STATUS 

D2 

=  MODSEL  STATUS 

D3 

-  ENALTSET  STATUS 

D4 

=  ENEXTIO  STATUS 

D5 

=  (NOT  USED) 

D6 

=  FAST  STATUS 

D7 

=  0 

Name:  LPOUT  * 

Port  Address:  F8  —  FB 

Access:  WRITE  ONLY 

Description:      Output  data  to  line  printer 


DO— D7 


=  ASCII  BYTE  TO  BE  PRINTED 


Name:  LPIN  " 

Port  Address:  F8—FB 

Access:  READONLY 

Description:  input  line  printer  status 


D0  —  D3 

-  (RESERVED) 

D4 

=  FAULT 

1  =  TRUE 

0  =  FALSE 

D5 

=  UNIT  SELECT 

1  =  TRUE 

0  =  FALSE 

D6 

=  OUTPAPER 

1  -  TRUE 

0  =  FALSE 

D7 

-  BUSY 

1  =  TRUE 

0  -  FALSE 

Name:  DRVSEL  * 

Port  Address:  F4  —  F7 

Access:  WRITE  ONLY 

Description:  Output  FDC  Configuration 

Note:     Output  to  this  port  will  ALWAYS  cause  a  1  -2  msec 
(Microsecond)  wait  to  the  Z80 


DO 

-  DRIVE  SELECT  0 

D1 

-  DRIVE  SELECT  1 

D2 

=  (RESERVED) 

D3 

=  (RESERVED) 

D4 

=  SDSEL 

0  =  SIDEO 

1  -  SIDE  1 

=  PRECOMPEN 

0  ^  No  write  precompensation 

1  =  Write  Precompensation  enabled 

=  WSGEN 

0  =  No  wait  state  generated 

1  -  wait  state  generated 

This  wait  state  is  to  sync  Z80  with  FDC  chip  during 
FDC  operation 

=  DDEN  * 

0  =  Single  Density  enabled  (FM) 

1  -  Double  Density  enabled  (MFM) 
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Name:  DISKOUT  * 

Port  Address:  FO  — F3 

Access:  WRITE  ONLY 

Description:      Output  to  FDC  Control  Registers 

Port  FO  =  FDC  Command  Register 

Port  F1  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  =  FDC  Data  Register 

(Refer  to  FDC  Manual  for  Bit  Assignments) 

Name:  DISKIN  * 

Port  Address:   FO— F3 

Access:  READ  ONLY 

Description:      Input  FDC  Control  Registers 

Port  FO  =  FDC  Status  Register 

Port  F1  =  FDC  Track  Register 

Port  F2  =  FDC  Sector  Register 

Port  F3  -  FDC  Data  Register 

(Refer  to  FDC  Manual  for  Bit  Assignment) 


Name:  MODOUT  * 

Port  Address:  EC  —  EF 

Access:  WRITE  ONLY 

Description:  Output  to  Configuration  Latch 

DO  =  (RESERVED) 

D1  =  CASSMOTORON  (Sound  enable) 

0  =  Cassette  Motor  Off  (Sound  enabled) 

1  =  Cassette  Motor  On  (Sound  disabled) 

D2  =  MODSEL 

0  =  64  or  80  character  mode 

1  =  32  or  40  character  mode 

D3  -  ENALTSET 

0  =  Alternate  character  set  disabled 

1  =  Alternate  character  set  enabled 


D4 

=  ENEXTIO 

0  =  External  IO  Bus  disabled 

1  =  External  IO  Bus  enabled 

D5 

=  (RESERVED) 

D6 

-  FAST 

0-2  MHZ  Mode 

1   =  4  MHZ  Mode 

D7 

-  (RESERVED) 

Name:  RTCiN ' 

Port  Address:  EC— EF 

Access:  READ  ONLY 

Description:  Clear  Real  Time  Clock  Interrupt 

D0—D7      =  DON'T  CARE 


Name:  RS2320UT  * 

Port  Address:   E8—EB 
Access:  WRITE  ONLY 

Description;      UART  Control.  Data  Control,  Modem  Control. 
BRG  Control 

Port  E8  =  UART  Master  Reset 

Port  E9  =  BAUD  Rate  Gen  Register 

Port  EA  =  UART  Control  Register  (Modem  Control  Reg  ) 

Port  EB  =  UART  Transmit  Holding  Reg 

(Refer  to  Model  III  or  4  Manual  for  Bit  Assignments) 

Name:  RS232IN  * 

Port  Address:  E8—  EB 

Access:  READONLY 

Description:  Input  UART  and  Modem  Status 

Port  E8  -  MODEM  STATUS 

Port  E9  =  (RESERVED) 

Port  EA  =  UART  Status  Register 

Port  EB  =  UART  Receive  Holding  Register  (Resets  DR) 

(Refer  to  Model  III  or  4  Manual  for  Bit  Assignments) 
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Name:  WRNM1MASKREG  * 

Port  Address:  E4  —  E7 
Access:  WRITE  ONLY 

Description:     Output  NMI  Latch 

DO— D5      =  (RESERVED) 

D6  -  ENMOTOROFFINT 

0  =  Disables  Motoroff  NMI 

1  =  Enables  Motoroff  NMI 

D7  -  EN1NTRQ 

0  -  Disables  INTRO  NMI 

1  ^  Enables  INTRO  NMI 


Name:  RDNMSSTATUS ' 

Port  Address:   E4  —  E7 
Access:  READ  ONLY 

Description:      Input  NMI  Status 


DO 


=  0 


02  — D4      =  (RESERVED) 


■  RESET  {not  needed) 

0  -  Reset  Asserted  (Problem) 

1  ■=  Reset  Negated 

=  MOTOROFF 

0  =  Motoroff  Asserted 

1  =  Motoroff  Negated 

--  INTRO 

0  =  INTRO  Asserted 

1  -  INTRO  Negated 


Name:  WRiNTMASKREG  " 

Port  Address:   EO  — E3 
Access:  WRITE  ONLY 

Description:      Output  INT  Latch 

00  —  D1       -(RESERVED) 

D2 


D3 


:  ENRTC 

0  =  Real  time  clock  interrupt  disabled 

1  =  Real  time  clock  interrupt  enabled 

■■  ENIOBUSINT 

0  =  External  IO  Bus  interrupt  disabled 

1  =  External  SO  Bus  interrupt  enabled 


D5  -  ENRECINT 

0  -  RS232  Rec  Data  Reg  full  inl  disabled 

1  -  RS232  Rec  Data  Reg  full  int  enabled 

D6  -  ENERRORINT 

0  -  RS232  UART  Error  interrupts  disabled 

1  -  RS232  UART  Error  interrupts  enabled 

D7  =  (RESERVED) 

Name:  RDINTSTATUS  • 

Port  Address:   EO—  E3 
Access:  READ  ONLY 

Description:      Input  INT  Status 

DO  — D1       =  (RESERVED) 

D2  =  RTC  INT 

D3  -  IOBUS  INT 

L>4  -  HSZik!  AM)  I  IN'I 

D5  =  RS232  REC  INT 

D6  -  RS232  UART  ERROR  INT 

D7  -  (RESERVED) 

Name:  BOOT  * 

Port  Address:  9C— 9F 

Access:  WRITE  ONLY 

Description:  Enable  or  Disable  Boot  ROM 

DO  -  ROM  ' 

0  =  Boot  ROM  Disabled 

1  =  Boot  ROM  Enabled 

01—07      -(RESERVED) 

Name:  SEN  ' 

Port  Address:  90—93 

Access:  WRITE  ONLY 

Description:  Sound  output 

DO  =  SOUND  DATA 

01—  D7      -(RESERVED) 


:  ENXMITINT 

0  =    RS232  Xmit  Holding   Reg    empty  int 
disabled 

1  -    RS232  Xmit  Holding   Reg    empty  int 
enabled 
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Name:  OPREG  * 

Port  Address:  84 

Access:  WRITE  ONLY 

Description:  Output  to  operation  reg 

DO  =  SELO 

D1  =  SEL1 


SEL1 
0 

0 
1 
1 

SELO 

0 
1 
0 

1 

MODE 
0 

1 
2 

3 

■  8064 

0  =  64  character  mode 

1  =  80  character  mode 

D3  =  INVERSE 

0  =  Inverse  video  disabled 

1  =  Inverse  video  enabled 

D4  -  SRCPAGE  —  Points  to  the  page  to  be  mapped 

as  new  page 

0  -  U64K,  L32K  Page 

1  =  U64K.  U32K  Page 

D5  =  ENPAGE  —  Enables  mapping  of  new  page 

0  ^  Page  mapping  disabled 

1  =  Page  mapping  enabled 

D6  =  DESPAGE  ~~  Points  to  the  page  where  new 

page  is  to  be  mapped; 

0  =  L64K,  U32K  Page 

1  -  L64K,  L32K  Page 

07  -  PAGE 

0  =  Page  0  of  Video  Memory 

1  =  Page  1  of  Video  Memory 
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42.8  Video  Circuit 

The  heart  of  the  video  display  circuit  in  the  Model  4P  is  the 
68045  Cathode  Ray  Tube  Controller  (CRTC).  U42  The  CRTC 
is  a  preprogrammed  video  controller  that  provides  two  screen 
formats:  64  by  1 6  and  80  by  24  The  format  is  controlled  by  pin 
3  of  the  CRTC  (8064*)  The  CRTC  generates  all  of  the  neces- 
sary signals  required  for  (he  video  display  These  signals  are 
VSYNC  (Vertical  Sync),  HSYNC  (Horizontal  Sync)  for  proper 
sync  of  the  monitor,  DISPEN  (Display  Enable)  which  indicates 
when  video  data  should  be  output  to  the  monitor,  the  refresh 
memory  addresses  (MA0-MA13)  which  addresses  the  video 
RAM,  and  the  row  addresses  (RA0-RA4)  which  indicates  which 
scan  line  row  is  being  displayed  The  CRTC  also  provides  hard- 
ware scrolling  by  writing  to  the  internal  Memory  Start  Address 
Register  by  OUTing  to  Port  88H  The  internal  cursor  control  of 
the  68045  is  not  used  in  the  Model  4P  video  circuit 

Since  the  80  by  24  screen  requires  1 ,920  screen  memory  lo- 
cations, a  2K  by  8  static  RAM  (U82)  is  used  for  the  video  RAM 
Addressing  to  the  video  RAM  (U82)  is  provided  by  the  68045 
when  refreshing  the  screen  and  by  the  CPU  when  updating  of 
the  data  is  performed  These  two  sets  of  address  lines  are  mul- 
tiplexed by  three  74LS157s  (U41,  U61.  and  U81)  The  multi- 
plexers are  switched  by  CRTCLK  which  allows  the  CRTC  to 
address  the  video  RAM  during  the  high  state  of  CRTCLK  and 
the  CPU  access  during  the  low  state  A1 0  from  the  CPU  is  con- 
trolled by  PAGE*  which  allows  two  display  pages  in  the  64  by 
16  format  When  updates  to  the  video  RAM  are  performed  by 
the  CPU,  the  CPU  is  held  in  a  WAIT  state  until  the  CRTC  is  not 
addressing  the  video  RAM  This  operation  allows  reads  and 
writes  to  video  RAM  without  causing  hashing  on  the  screen 
The  circuit  that  performs  this  function  is  a  74LS244  buffer 
(U84).  an  8  bit  transparent  latch,  74LS373  (U83)  and  a  Delay 
line  circuit  shared  with  Dynamic  RAM  timing  circuit  consisting 
of  a  74LS74  (U98),  74LS32  (U96),  74LS04  (U95).  74LSO0 
(U92),  74LS02  (U69).  and  Delay  Line  (U94)  During  a  CPU 
Read  Access  to  the  Video  RAM,  the  address  is  decoded  by  the 
GA  4  2  and  asserts  VIDEO*  low  This  is  inverted  by  U95  (1  '6  of 
74LS04)  which  pulls  one  input  of  U92  (1/4  of  74LS00)  and  in 
turn  asserts  VWAIT  *  low  to  the  CPU  RD  is  high  at  this  time  and 
is  latched  into  U98  (1/2  of  74LS74)  on  the  rising  edge  of 
XADR7*.  inverse  of  CRTCLK 


When  RD  is  latched  by  U98,  the  Q  output  goes  low  releasing 
WAIT*  from  the  CPU  The  same  signal  also  is  sent  to  the  Delay 
Line  (U94)  through  U1 1 7  (1  /4  of  74F08)  The  Delay  line  delays 
the  failing  edge  240  ns  for  VLATCH*  which  latches  the  read 
data  from  the  video  RAM  at  U83.  The  data  is  latched  so  the 
CRTC  can  refresh  the  next  address  location  and  prevent  any 
hashing  MRD*  decoded  by  U106  and  a  memory  read  is  ORed 
with  VIDEO*  which  enables  the  data  from  U83  to  the  data  bus 
The  CPU  then  reads  the  data  and  completes  the  cycle  A  CPU 
write  is  slightly  more  complex  in  operation  As  in  the  RD  cycle, 
VIDEO'  is  asserted  low  which  asserts  VWAIT*  low  to  the  CPU 
WR  is  high  at  this  time  which  is  NANDed  with  VIDEO  and 
synced  with  CRTCLK  to  create  VRAMDSS  that  disables  the 
video  RAM  output  On  the  rising  edge  of  XADR7*,  WR  is 
latched  into  U98  (1/2  of  74LS74)  which  releases  VWAIT*  and 
starts  cycle  through  the  Delay  Line  After  30ns  DLYVWR*  (De- 
layed video  write)  is  asserted  low  which  also  asserts  VBUFEN* 
(Video  Buffer  Enable)  low  VBUFEN*  enabled  data  from  the 
Data  bus  to  the  video  RAM  Approximately  120ns  later 
DLYVWR*  is  negated  high  which  writes  the  data  to  the  video 
RAM  and  negates  VBUFEN*  turning  off  buffer  The  CPU  then 
completes  WR  cycle  to  the  video  RAM  Refer  to  Video  RAM 
CPU  Access  Timing  Figure  5-12  for  timing  of  above  RD  or  WR 
cycles 

During  screen  refresh.,  CRTCLK  is  high  allowing  the  CRTC 
to  address  Video  RAM  The  data  out  of  the  video  RAM  is 
latched  by  LOAD*  into  Gate  Array  4  3  (U102)  INVERSE* 
determines  if  character  should  be  alpha-numeric  only  (IN- 
VERSE* high)  or  unchanged  (INVERSE*  low)  A9  is  de- 
coded with  ENALTSET  (Enable  Alternate  Set)  and  7.  which 
controls  the  alternate  set  in  the  character  generator  ROM 
See  ENALTSET  Control  Table  below 


ENALTSET 

Q7 

Q6 

A9 

0 

0 

0 

0 

0 

1 

0 

0 

0 

1 

1 

1 

1 

0 

0 

0 

1 

0 

1 

1 

1 

1 

0 

0 

1 

1 

1 

0 
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RA0-RA3,  row  addresses  from  the  CRTC  are  used  to  control 
which  scan  line  is  being  displayed  The  Model  4P  has  a  4-bit  full 
adder  74L3263  (U101)  to  modify  the  Row  address  During  a 
character  display  DLYGRAPHIC*  is  high  which  applies  a  high  to 
all  4  bits  to  be  added  to  row  address  This  will  result  in  subtract- 
ing one  from  Row  address  count  and  allow  all  characters  to  be 
displayed  one  scan  line  lower  The  purpose  is  so  inverse  char- 
acters will  appear  within  the  inverse  block  When  a  graphic 
block  is  displayed  DLYGRAPHIC*  is  low  which  causes  the  row 
address  to  be  unmodified  Moving  jumper  from  E14-E15  to 
E15-E16  will  disable  this  circuit 

DLYCHAR*  and  DLYGRAPHICS  are  inverse  signals  and  control 
which  data  is  to  be  loaded  into  the  internal  shift  register  of  U1 02 
When  DLYCHAR'  is  low  and  DLYGRAPHIC*  is  high,  the  Char- 
acter Generator  ROM  (U103)  is  enabled  to  output  data  When 
DLYCHAR*  is  high  and  DLYGRAPHIC*  is  low  the  graphics  char- 
acters are  internally  buffered  to  the  shift  register  The  data  is 
loaded  into  the  internal  shift  register  on  the  rising  edge  of 
SHIFT*  when  LOADS*  is  low  Serial  video  data  is  output 
U102  19  The  video  information  is  inverted  by  U142  and  F83,  is 
filtered  by  R14  (47  ohm  resistor),  and  C227  (100  pf  Cap)  and 
output  to  video  monitor.  VSYNC  and  HSYNC  are  buffered  by  ( 1  / 
2  of  74LS86)  U1 43  and  are  also  output  to  video  monitor  Refer 
to  Video  Circuit  Timing  Figure  4-12  and  Inverse  Video  Tim- 
ing Figure  4-13  for  timing  relationships  of  Video  Circuit. 

4.2.9  Keyboard 

The  keyboard  interlace  of  the  Model  4P  consists  of  open  col- 
lector drivers  which  drive  an  8  by  8  key  matrix  keyboard  and  an 
inverting  buffer  which  buffers  the  key  or  keys  pressed  on  the 
data  bus  The  open  collector  drivers  (U57  and  U77  (7416)  are 
driven  by  address  lines  AO-A7  which  drive  the  column  lines  of 
the  keyboard  matrix  The  ROW  Sines  of  the  keyboard  are  pulled 
up  by  a  1  5  kohm  resistor  pack  RP2  The  ROW  lines  are  buff- 
ered and  inverted  onto  the  data  bus  by  U78  (74LS240)  which  is 
enabled  when  KEYBD*  is  a  logic  low  KEYBD'  is  a  memory 
mapped  decode  of  addresses  3800-3BFF  in  Model  HI  Mode 
and  F400-F7FF  in  Mode!  4/4P  mode  Refer  to  the  Memory  Map 
under  Address  Decode  for  more  information  During  real  time 
operation,  the  CPU  will  scan  the  keyboard  periodically  to  check 
if  any  keys  are  pressed  If  no  key  is  pressed,  the  resistor  pack 
RP2  keeps  the  inputs  of  U78  at  a  logic  high  U78  inverts  the 
data  to  a  logic  low  and  buffers  it  to  the  data  bus  which  is  read 
by  the  CPU  If  a  key  is  pressed  when  the  CPU  scans  the  correct 
column  line,  the  key  pressed  will  pull  the  corresponding  row  to 
a  logic  low  U78  inverts  the  signal  to  a  logic  high  which  is  read 
by  the  CPU 


4.2.10  Real  Time  Clock 

The  Real  Time  Clock  circuit  in  the  Model  4P  provides  a  30  Hz 
(in  the  2  MHz  CPU  mode)  or  60  Hz  (in  the  4  MHz  CPU  mode) 
interrupt  to  the  CPU  By  counting  the  number  of  interrupts  that 
have  occurred,  the  CPU  can  keep  track  of  the  time  The  60  Hz 
vertical  sync  signal  (VSYNC)  from  the  video  circuitry  is  used  for 
the  Real  Time  Clocks  reference  In  the  2  MHz  mode,  FAST  is 
a  logic  low  which  sets  the  Preset  input,  pin  4  of  U23  (74LS74), 
to  a  logic  high  This  allows  the  60  Hz  (VSYNC)  to  be  divided  by 
2  to  30  Hz  The  output  of  1/2  of  U23  is  ORed  with  the  original 
60  Hz  and  then  clocks  another  74LS74  (1/2  of  U23)  If  the  real 
time  clock  is  enabled  (ENRTC  at  a  logic  high),  the  interrupt  is 
latched  and  pulls  the  INT*  line  low  to  the  CPU  When  the  CPU 
recognizes  the  interrupt,  the  pulse  is  counted  and  the  latch  re- 
set by  pulling  RTCSN*  low  in  the  4  MHz  mode,  FAST  is  a  logic 
high  which  keeps  the  first  half  of  U23  in  a  preset  state  (the  Q* 
output  at  a  logic  low)  The  60  Hz  is  used  to  clock  the  interrupts 

NOTE:  If  interrupts  are  disabled,  the  accuracy  of  the  real 
time  clock  will  suffer 

4.2.11  Line  Printer  Port 

The  Line  Printer  Port  Interface  consists  of  a  pulse  generator,  an 
eight-bit  latch,  and  a  status  line  buffer  The  status  of  the  line 
printer  is  read  by  the  CPU  by  enabling  buffer  U3  (74LS244) 
This  buffer  is  enabled  by  LPRD*  which  is  a  memory  map  and 
port  map  decode  In  Model  III  mode,  only  the  status  can  be  read 
from  memory  location  37E8  or  37E9  The  status  can  be  read  in 
all  modes  by  an  input  from  ports  F8-FB  For  a  listing  of  the  bit 
status,  refer  to  Port  Map  section 

After  the  printer  driver  software  determines  that  the  printer  is 
ready  for  printing  (by  reading  the  correct  status),  the  characters 
to  be  printed  are  output  to  Port  F8-FB  U2,  a  74LS374  eight-bit 
latch,  latches  the  character  byte  and  outputs  to  the  line  printer 
One-half  of  U1  (74LS123),  a  one-shot,  is  then  triggered  which 
generates  an  appropriate  strobe  signal  to  the  printer  which  sig- 
nifies a  valid  character  is  ready  The  output  of  the  one-shot  is 
buffered  by  1  /6th  of  the  U51  (74LS04)  to  prevent  noise  from  the 
printer  cable  from  false-triggering  the  one-shot 
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4.2.12  Graphics  Port 


The  Graphics  Port  (J7)  on  the  Model  4P  is  provided  to  attach 
the  optional  Graphics  Board  The  port  provides  D0-D7  {Data 
Lines),  A0-A3  {Address  Lines).  IN*.  GEN*  and  RESET*  for  the 
necessary  interface  signals  for  the  Graphics  Board  GEN*  is 
generated  by  negative  ORing  Port  selects  GSELO*  (8C-8FH) 
and  GSELI'  (80-83H)  together  by  (1/4  of  74LS08)  U4  The  re- 
sulting signal  is  negative  ANDed  with  IORQ*  by  (1/4  of  74S32) 
U24  Seven  timing  signals  are  provided  to  aliow  synchroniza- 
tion of  Main  Logic  Board  Video  and  Graphics  Board  Video 
These  timing  signals  are  VSYNC,  HSYNC,  DiSPEN,  DCLK, 
H,  I,  and  J.  Three  control  signals  from  the  Graphics  Board 
are  used  to  sync  to  CPU  access  and  select  different  video 
modes.  WAIT*  controls  the  CPU  access  by  causing  the  CPU 
to  WAIT  tili  video  is  in  retrace  area  before  allowing  any 
writes  or  reads  to  Graphics  Board  RAM  ENGRAF  is  as- 
serted when  Graphics  video  is  displayed  ENGRAF  also  dis- 
ables inverse  video  mode  on  Main  Logic  Board  Video 
CL166"  (Clear  74L166)  is  used  to  enable  or  disable  mixing 
of  Main  Logic  Board  Video  and  Graphics  Board  Video  if 
ni  ififi*  k  npnatpH  high  thpn  mixing  is  allowed  in  all  four 
video  modes  80  x  24,  40  x  24,  64  x  16,  and  32  x  16  If 
CL166*  is  asserted  low,  this  will  clear  the  video  shift  register 
U63,  which  allows  no  video  from  the  Main  Logic  Board  in 
this  state  8064*  is  automatically  asserted  low  to  put  screen 
in  80  x  24  video  mode  Refer  to  Figure  4-15  Graphic  Board 
Video  Timing  for  timing  relationships.  Refer  to  the  Model  4/ 
4P  Graphics  Board  Service  information  for  service  or  techni- 
cal information  on  the  Graphics  Board 

4.2.13  Sound 

The  sound  circuit  in  the  Model  4P  is  compatible  with  the  Sound 
Board  which  was  optional  in  the  Model  4  Sound  is  generated 
by  alternately  setting  and  clearing  data  bit  DO  during  an  OUT  to 
port  90H  The  state  of  DO  is  latched  by  U129  (1/2  of  a  74LS74) 
and  the  output  is  amplified  by  Q2  which  drives  a  8J1  speaker 
The  speed  of  the  software  loop  determines  the  frequency,  and 
thus,  the  pitch  of  the  resulting  tone  Since  the  Model  4P  does 
not  have  a  cassette  circuit,  some  existing  software  that  used 
the  cassette  output  for  sound  would  have  been  lost  The  Model 
4P  routes  the  cassette  latch  to  the  sound  board  through  U109 
When  the  CASSMOTORON  signal  is  a  logic  low,  the  cassette 
motor  is  off,  then  the  cassette  output  is  sent  to  the  sound  circuit 

4.2.14  I/O  Bus  Port 

The  Model  4P  Bus  is  designed  to  allow  easy  and  convenient  in- 
terfacing of  I/O  devices  to  the  Model  4P  The  I/O  Bus  supports 
all  the  signals  necessary  to  implement  a  device  compatible  with 
the  Z80s  I/O  structure 


A0  to  A7  allow  selection  of  up  to  256*  input  and  256  output 
devices  if  external  I/O  is  enabled 

'Ports  80H  to  OFFH  are  reserved  for  System  use 

Data: 

DBO  to  DB7  allow  transfer  of  8-bit  data  onto  the  processor 
data  bus  is  external  I/O  is  enabled 

Control  Lines: 

1  M1*  —  Z80A  signal  specifying  an  M1  or  Operation  Code 
Fetch  Cycle  or  with  IOREQ\  it  specifies  an  Interrupt 
acknowledge 

2  IN*  —  Z80A  signal  specifying  than  an  input  is  in  progress 
Logic  AND  of  IOREQ*  and  WR* 

3  OUT*  —  Z80A  signal  specifying  that  an  output  is  in  prog- 
ress Logic  AND  oMOREO*  and  WR* 

4  IOREQ*  ~~  Z80A  signal  specifying  that  an  input  or  output 
is  in  progress  or  with  M1*.  it  specifies  an  interrupt 
acknowledge 

5  RESET'  —  system  reset  signal 

6  IOBUSINT*  —  input  to  the  CPU  signaling  an  interrupt  from 
an  I/O  Bus  device  if  I/O  Bus  interrupts  are  enabled 

7  IOBUSWAIT*  —  input  to  the  CPU  wait  line  allowing  I/O  Bus 
device  to  force  wait  states  on  the  Z80  if  external  I/O  is 
enabled 

8  EXTIOSEL*  —  input  to  I/O  Bus  Port  circuit  which  switches 
(he  I/O  Bus  data  bus  transceiver  and  allows  and  INPUT  in- 
struction to  read  I/O  Bus  data 

The  address  line,  data  Sine,  and  a!!  control  lines  except  RESET' 
are  enabled  only  when  the  ENEXIO  bit  in  port  EC  is  set  to  one 

To  enable  I/O  interrupts,  the  ENIOBUSINT  bit  in  the  PORT  E0 
(output  port)  must  be  a  one  However  even  if  it  is  disabled  from 
generating  interrupts,  the  status  of  the  IOBUSINT*  Sine  can  still 
read  on  the  appropriate  bit  of  CPU  IOPORT  E0  (input  port) 

See  Model  4P  Port  Bit  assignments  for  port  OFF,  OEC,  and  OE0 
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The  Model  4P  CPU  board  is  fully  protected  from  "foreign  I/O  de- 
vices in  that  all  the  I/O  Bus  signals  are  buffered  and  can  be  dis- 
abled under  software  control  To  attach  and  use  and  I/O  device 
on  the  I/O  Bus,  certain  requirements  (both  hardware  and  soft- 
ware)  must  be  met 

For  input  port  device  use,  you  must  enable  external  I/O  de- 
vices by  writing  to  port  OECH  with  bit  4  on  in  the  user  soft- 
ware This  will  enable  the  data  bus  address  lines  and  control 
signals  to  the  I/O  Bus  edge  connector  When  the  input  de- 
vice is  selected,  the  hardware  should  acknowledge  by  as- 
serting EXTIOSEL*  low  This  switches  the  data  bus 
transceiver  and  allows  the  CPU  to  read  the  contents  of  the  !/ 
O  Bus  data  lines  See  Figure  4-16  for  the  timing,  EXTIO- 
SEL* can  be  generated  by  NANDing  IN  and  the  I/O  port 
address. 

Output  port  device  use  is  the  same  as  the  input  port  device  in 
use,  in  that  the  external  I/O  devices  must  be  enabled  by  writing 
to  port  OECH  with  bit  4  on  in  the  user  software  —  in  the  same 
fashion 

For  either  input  or  output  devices,  the  lOBUSWAIT*  control  line 
can  be  used  in  the  norma!  way  tor  syncnromzing  slow  aevtces 
to  the  CPU  Note  that  since  dynamic  memories  are  used  in  the 
Model  4P,  the  wait  line  should  be  used  with  caution  Holding  the 
CPU  in  a  wait  state  for  2  msec  or  more  may  cause  loss  of  mem- 
ory contents  since  refresh  is  inhibited  during  this  time  It  is  rec- 
ommended that  the  iOBUSWAIT*  line  be  held  active  no  more 
than  500  ^isec  with  a  25%  duty  cycle 

The  Model  4P  will  support  280  Mode  1  interrupts  A  RAM  jump 
table  is  supported  by  the  LEVEL  II  BASIC  ROMs  image  and  the 
user  must  supply  the  address  of  his  interrupt  service  routine  by 
writing  this  address  to  locations  403E  and  403F  When  an  in- 
terrupt occurs,  the  program  will  be  vectored  to  the  user-sup- 
plied address  if  I/O  Bus  interrupts  have  been  enabled  To 
enable  I/O  Bus  interrupts,  the  user  must  set  bit  3  of  Port  OE0H 

4.2.15  FDC  Circuit 

The  TRS-80  Model  4P  Floppy  Disk  Interface  provices  a  stan- 
dard 5-1/4"  floppy  disk  controller  The  Floppy  Disk  Interface 
supports  both  single  and  double  density  encoding  schemes 
Write  precompensation  can  be  software  enabled  or  disabled 
beginning  at  any  track,  although  the  system  software  enables 
write  precompensation  for  all  tracks  greater  than  twenty-one 
The  amount  of  write  precompensation  is  125  nsec  and  is  not 
adjustable  One  or  two  drives  may  be  controlled  by  the  inter- 
face All  data  transfers  are  accomplished  by  CPU  data  re- 
quests In  double  density  operation,  data  transfers  are 
synchronized  to  the  CPU  by  forcing  a  wait  to  the  CPU  and  clear- 
ing the  wait  by  a  data  request  from  the  FDC  chip  The  end  of  the 
data  transfer  is  indicated  by  generation  of  a  non-maskable  in- 
terrupt from  the  interrupt  request  output  of  the  FDC  chip  A 
hardware  watchdog  timer  insures  that  any  error  condition  will 
not  hang  the  wait  line  to  the  CPU  for  a  period  long  enough  to 
destroy  RAM  contents 
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Control  and  Data  Buffering 


*OnSy  one  of  these  bits  should  be  set  per  output 


The  Floppy  Disk  Controller  Board  is  an  I/O  port-mapped  device 
which  uiilizes  poris  E4H  FOH.  F1H.  F2IS.  F3H.  and  F4H  The 
decoding  logic  is  implemented  on  the  CPU  board  (Refer  to  Par- 
agraph 5  1  5  Address  Decoding  for  more  information  on  Port 
Map)  U70  is  a  bi-directional,  8-bit  transceiver  used  to  buffer 
data  to  and  from  the  FDC  and  RS-232  circuits  The  direction  of 
data  transfer  is  controlled  by  the  combination  of  control  signals 
DISKIN*,  RS2321N*.  RDINT*.  and  RDNMI*  If  any  of  these  sig- 
nals is  active  (logic  low),  U70  is  enabled  to  drive  data  onto  the 
CPU  data  bus  If  both  signals  are  inactive  (logic  high),  U70  is' 
enabled  to  receive  data  from  the  CPU  board  data  bus  A  sec- 
ond buffer  (U36)  is  used  to  buffer  the  FDC  chip  data  to  the  FDC/ 
RS232  Data  Bus.  (BD0-BD7),  U36  is  enabled  all  the  time  and 
its  direction  controlled  by  DISKIN*  Again,  if  DISKIN*  is  active 
(logic  low),  data  is  enabled  to  drive  from  the  FDC  chip  to  the 
Main  Data  Busses  If  DISKIN*  is  inactive  (logic  high),  data  is  en- 
abled to  be  transferred  to  the  FDC  chip 

Nonmaskable  Interrupt  Logic 

Gate  Array  4  4  (U 1 8)  is  used  to  latch  data  bits  D6  and  D7  on  the 
rising  edge  of  the  control  signal  WRNMI"  This  enables  the  con- 
ditions which  will  generate  a  non-maskable  interrupt  to  the 
CPU  The  NMi  interrupt  conditions  which  are  programmed  by 
doing  an  OUT  instruction  to  port  E4H  with  the  appropriate  bits 
set  If  data  bit  7  is  set,  an  FDC  interrupt  is  enabled  to  generate 
an  NMI  interrupt  If  data  bit  7  is  reset,  interrupt  requests  request 
from  the  FDC  are  disabled  If  data  bit  6  is  set,  a  Motor  Time  Out 
is  enabled  to  generate  an  NMI  interrupt  If  data  bit  6  is  reset,  in- 
terrupts on  Motor  Time  Out  are  disabled  An  IN  instruction  from 
port  E4H  enables  the  CPU  to  determine  the  source  of  the  non- 
maskable interrupt  Data  bit  7  indicates  the  status  of  FDC  in- 
terrupt request  (INTRQ)  (0  =  true,  1  =  false)  Data  bit  6  indicates 
the  status  of  Motor  Time  Out  (0  =  true,  1  =  false)  Data  bit  5  in- 
dicates the  status  of  the  Reset  signal  (0  =  true,  1  =  false)  The 
control  signal  RDNMI*  gates  this  status  onto  the  CPU  data  bus 
when  active  (logic  low) 

Drive  Select  Latch  and  Motor  ON  Logic 

Selecting  a  drive  prior  to  disk  I/O  operation  is  accomplished  by 
doing  an  OUT  instruction  to  port  F4H  with  the  proper  bit  set  The 
following  table  describes  the  bit  allocation  of  the  Drive  Select 
Latch: 


Hex  D  flip-flop  U54  (74L174)  latches  the  drive  select  bits,  side 
select  and  FM'/MFivi  bits  on  the  rising  edge  of  trie  control  signal 
DRVSEL*  Gate  Array  4  4  (U18)  is  used  to  latch  the  Wait  Ena- 
ble and  Write  precompensation  enable  bits  on  the  rising  edge 
of  DRVSEL*  The  rising  edge  of  DRVSEL*  also  triggers  a  one- 
shot  (1/2  of  U54.  74LS123)  which  produces  a  Motor  On  to  the 
disk  drives  The  duration  of  the  Motor  On  signal  is  approxi- 
mately three  seconds  The  spindle  motors  are  not  designed  for 
continuous  operation  Therefore,  the  inactive  stale  of  (he  Motor 
On  signal  is  used  to  clear  the  Drive  Select  Latch,  which  de-se- 
lects any  drives  which  were  previously  selected  The  Motor  On 
one-shot  is  retriggerable  by  simply  executing  another  OUT  in- 
struction to  the  Drive  Select  Latch 

Wait  State  Generation  and  WAITIMOUT  Logic 

As  previously  mentioned,  a  wait  state  to  the  CPU  can  be  initi- 
ated by  an  OUT  to  the  Drive  Select  Latch  with  D6  set  Pin  18  of 
U18  will  go  high  after  this  operation  This  signal  is  inverted  by 
1/4th  of  U15  and  is  routed  to  the  CPU  where  it  forces  the  Z80A 
into  a  wait  state  The  Z80A  will  remain  in  the  wait  state  as  long 
as  WAIT*  is  low  Once  initiated,  the  WAIT*  will  remain  low  until 
one  of  five  conditions  is  satisfied  If  INTRO.  DRQ,  and  RESET, 
inputs  become  active  (logic  high),  it  causes  WAIT'  to  go  high 
which  allows  the  280  to  exit  the  waif  state  An  internal  timer  in 
U1 8  serves  as  a  watchdog  timer  to  insure  that  a  wait  condition 
will  not  persist  long  enough  to  destroy  dynamic  RAM  contents 
This  internal  watchdog  timer  logic  will  limit  the  duration  of  a  wait 
to  1024M-sec,  even  if  the  FDC  chip  should  fail  to  generate  a 
DRQ  or  an  INTRQ 

If  an  OUT  to  Drive  Select  Latch  is  initiated  with  D6  reset  (logic 
low).,  a  WAIT  is  still  generated  The  internal  timer  in  U18  will 
count  to  2  which  will  clear  the  WAIT  state  This  allows  the  WAIT 
to  occur  only  during  the  OUT  instruction  to  prevent  violating  any 
Dynamic  RAM  parameters 


NOTE: 


This  automatic  WAIT  will  cause  a  5-1  ^sec  wait  each 
time  an  out  to  Drive  Select  Latch  is  performed 


Data  Bit 

DO 
D1 
D2 
D3 

D4 

D5 

D6 
D7 


Function 

Selects  Drive  0  when  set* 

Selects  Drive  1  when  set* 

Selects  Drive  2  when  set* 

Selects  Drive  3  when  set' 

Selects  Side  0  when  reset 

Selects  Side  1  when  set 

Write  precompensation  enabled  when  set, 

disabled  when  reset 

Generates  WAIT  if  set 

Selects  MFM  mode  if  set 

Selects  FM  mode  if  reset 
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Clock  Generation  Logic 

A 1 6  MHz  crystal  oscillator  and  a  Gate  Array  4  4  (U1 8)  are  used 
to  generate  the  clock  signals  required  by  the  FDC  board  The  6 
MHz  oscillator  is  implemented  internal  to  U18  and  a  quartz 
crystal  (Y2)  The  output  of  the  oscillator  is  divided  by  2  to  gen- 
erate an  8  MHz  clock  This  is  used  by  the  FDC  1773  lor  all  in- 
ternal timing  and  data  separation  U18  further  divides  the  16 
MHz  clock  to  drive  the  watchdog  timer  circuit 

Disk  Bus  Output  Drivers 

High  current  open  collector  drivers  U15  and  U34  are  used  to 
buffer  the  output  signals  from  the  FDC  circuit  to  the  disk  drives 

Write  Precompensation  and  Write  Data  Pulse  Shap- 
ing Logic 

Al!  Write  Precompensation  is  generated  interna!  to  the  FDC 
chip  1773  (U17)  Write  Precompensation  is  enabled  when 
W6  goes  high  and  Write  Precompensation  is  enabled  from 
software  This  signal  is  multiplexed  with  RDY  by  W6  is  fed 
into  pin  20  of  U17  Write  Data  is  output  pin  22  of  U17  and  is 
shaped  by  a  one-shot  {1/2  of  U56)  which  stretches  the  data 
pulses  to  approximately  500  nsec 
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Floppy  Disk  Controller  Chip 


BRG  Programming  Table 


The  1773  is  an  MOS  LSI  device  which  performs  the  functions 
of  a  floppy  disk  formatter/controller  in  a  single  chip  implemen- 
tation The  following  port  addresses  are  assigned  to  the  internal 
registers  of  the  1773  FDC  chip: 


Port  No. 

Function 

FOH 

Command/Status  Register 

F1H 

Track  Register 

F2H 

Sector  Register 

F3H 

Data  Register 

4.2.16  RS-232-C  Circuit 

RS-232C  Technical  Description 

The  RS-232C  circuit  for  the  Model  4P  computer  supports 
asynchronous  serial  transmissions  and  conforms  to  the  EIA 
RS-232C  standards  at  the  input-output  interface  connector 
(J4)   The  heart  of  the  circuit  is  the  TR1865  Asynchronous 

the  parallel  byte  data  from  the  CPU  to  a  serial  data  stream 
including  start,  stop,  and  parity  bits  For  a  more  detailed  de- 
scription of  how  this  LSI  circuit  pedorrns  these  functions,  re- 
fer to  the  TR1865  data  sheets  and  application  notes  The 
transmit  and  receive  clock  rates  that  the  TR1865  needs  are 
supplied  by  the  Baud  Rate  Generator  U73  (BR1943)  This 
circuit  takes  the  5.0688  MHz  supplied  by  the  system  timing 
circuit  and  the  programmed  information  received  from  the 
CPU  over  the  data  bus  and  divides  the  basic  clock  rate  to 
provide  two  clocks  The  rates  available  from  the  BRG  go 
from  50  Baud  to  19200  Baud  See  the  BRG  table  for  the 
complete  list 


Receive 

Supported 

Nibble 

Baud 

16X 

by 

Loaded 

Rate 

Clock 

SETCOM 

OH 

50 

0  8  kHz 

Yes 

1H 

75 

1  2  kHz 

Yes 

2H 

110 

1.76  kHz 

Yes 

3H 

134  5 

2.1523  kHz 

Yes 

4H 

150 

2  4  kHz 

Yes 

5H 

300 

4.8  kHz 

Yes 

6H 

600 

9  6  kHz 

Yes 

7H 

1200 

19.2  kHz 

Yes 

8H 

1800 

28  8  kHz 

Yes 

9H 

2000 

32.081  kHz 

Yes 

AH 

2400 

38.4  kHz 

Yes 

BH 

3600 

57  6  kHz 

Yes 

CH 

4800 

76.8  kHz 

Yes 

DH 

7200 

11 5..2  kHz 

Yes 

FH 

9600 

153  6  kHz 

Yes 

FH 

19200 

307.2  kHz 

Yes 

The  RS-232C  circuit  is  port  mapped  and  the  ports  used  are  E8 
to  EB  Following  is  a  description  of  each  port  on  both  input  and 
output 


Port 

Input 

Output 

E8 

Modem  status 

Master  Reset,  enables  UART 
control  register  load 

EA 

UART  status 

UART  control  register  load  and 
modem  control 

E9 

Not  Used 

Baud  rate  register  load  enable 

bit 

Transmitter  Holding 

EB 

Receiver  Holding 

register 

register 

Interrupts  are  supported  in  the  RS-232C  circuit  by  the  Interrupt 
mask  register  and  the  Status  register  internal  to  GA  4  5  (U31) 
which  allow  the  CPU  to  see  which  kind  of  interrupt  has  oc- 
curred Interrupts  can  be  generated  on  receiver  data  register 
full,  transmitter  register  empty,  and  any  one  of  the  errors  —  par- 
ity, framing,  or  data  overrun  This  allows  a  minimum  of  CPU 
overhead  in  transferring  data  to  or  from  the  UART  The  interrupt 
mask  register  is  port  E0  (write)  and  the  interrupt  status  register 
is  port  E0  (read)  Refer  to  the  IO  Port  description  for  a  full  break- 
down of  all  interrupts  and  their  bit  positions 
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Al!  Model  I,  III,  and  4  software  written  for  the  RS-232-C  interface 
is  compatible  with  the  Model  4P  RS-232-C  circuit,  provided  the 
software  does  not  use  the  sense  switches  to  configure  the  in- 
terface The  programmer  can  get  around  this  problem  by  di- 
rectly programming  the  BRG  and  UART  for  the  desired 
configuration  or  by  using  the  SETCOM  command  of  the  disk 
operating  system  to  configure  the  interface  The  TRS-80  RS- 
232C  Interface  hardware  manual  has  a  good  discussion  of  the 
RS-232C  standard  and  specific  programming  examples  (Cat- 
alog Number  26-1 1 45). 

Pinout  Listing 

The  following  list  is  a  pinout  description  of  the  DB-25  connector 
(PI) 


Pin  No. 

Signal 

1 

PGND  (Protective  Ground) 

2 

TD  (Transmit  Data) 

3 

RD  (Receive  Data) 

4 

RTS  (Request  to  Send) 

5 

CTS  (Clear  To  Send) 

6 

DSR  (Data  Set  Ready) 

7 

SGND  (Signal  Ground) 

8 

CD  (Carrier  Detect) 

19 

SRTS  (Spare  Request  to  Send} 

20 

DTR  (Data  Terminal  Ready) 

22 

Rl  (Ring  Indicate) 
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Model  4P  Gate  Array 
I/O  Pin  Assignments 


J1 


J2 


J3 


Pin  Signal 
No 

Pin 
No. 

1, 

Signal 

Pin 
No. 

1. 

Signal 

1*   DATA  STROBE 

XD0 

XD0 

2,.    GND 

2. 

GND 

2 

GND 

3,    PDO 

3, 

XD1 

3 

XD1 

4,    GND 

4 

GND 

4 

GND 

5,    PD1 

5 

XD2 

5,. 

XD2 

6,    GND 

6, 

GND 

6,, 

GND 

7,    PD2 

7„ 

XD3 

1 

XD3 

8,    GND 

8. 

GND 

8 

GND 

9,    PD3 

9. 

XD4 

9 

XD4 

10,    GND 

10 

GND 

10 

GND 

11.    PD4 

11 

XD5 

11 

XD5 

12.    GND 

12. 

GND 

12, 

GND 

13     PD5 

13, 

XD6 

13. 

XD6 

14     GND 

14. 

GND 

14. 

GND 

15.    PD6 

15 

XD7 

15, 

XD7 

16.    GND 

16 

GND 

16. 

GND 

17„    PD7 

17. 

XA0 

17 

XA0 

<o      r?Mn 

13 

GND 

^  P 

GND 

ia  u/ a 

19 

xaT 

19 

xaT 

20.    GND 

20. 

GND 

20 

GND 

21.    BUSY 

21, 

XA2 

21. 

XA2 

22     GND 

22. 

GND 

22,. 

GND 

23.    OUTPAPER 

23. 

XA3 

23,. 

XA3 

24,    GND 

24 

GND 

24 

GND 

25.    UNIT  SELECT 

25 

XA4 

25 

XA4 

26.    NC 

26, 

GND 

26. 

GND 

27,    GND 

27, 

XA5 

27 

XA5 

28     FAULT 

28 

GND 

28, 

GND 

29,    N/A 

29 

XA6 

29 

XA6 

30,    N/A 

30 

GND 

30, 

GND 

31.    NC 

31 

XA7 

31. 

XA7 

32.    N/A 

32, 

GND 

32. 

GND 

33.    NC 

33,. 

XIN* 

33, 

XIN* 

34,    GND 

34. 

GND 

34 

GND 

35, 

35 

XOUT* 

35 

XOUT* 

36 

36 

GND 

36,. 

GND 

37, 

37 

XRESET* 

37, 

XRESET* 

38. 

38, 

GND 

38 

GND 

39. 

39,. 

IOBUSINT* 

39 

IOBUSINT* 

40 

40. 

GND 

40 

GND 

41. 

41 

lOBUSWAIT* 

41. 

lOBUSWAIT* 

42 

42. 

GND 

42. 

GND 

43 

43 

EXTIOSEL* 

43 

EXTIOSEL* 

44, 

44 

GND 

44 

GND 

45. 

45 

NC 

45„ 

NC 

46,. 

46, 

GND 

46. 

GND 

47. 

47,. 

XMl* 

47 

XMI* 

48. 

48 

GND 

48 

GND 

49 

49. 

XiOREG* 

49 

XIOREQ* 

50 

50. 

GND 

50. 

GND 
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J4 


J5 


J7 


J9 


Pin 

Signal 

No, 

1. 

PGND 

2. 

TD 

3. 

RD 

4., 

CTS 

5. 

DSR 

6. 

CD 

7. 

SGND 

8. 

CD 

9. 

10., 

11. 

12 

13., 

14, 

15, 

16, 

17 

18 

19, 

SRTS 

20 

DTR 

21. 

22 

Rl 

23 

24. 

25 

26 

27., 

28. 

29 

30., 

31, 

32 

33. 

34. 

Pin   Signal 

Pin 

Signal 

No. 

No, 

1.    GND 

1, 

DO 

2, 

2, 

D1 

3.    GND 

3, 

D2 

4. 

4, 

D3 

5,    GND 

5. 

D4 

6, 

6, 

D5 

7,    GND 

7, 

D6 

8.    DIP* 

8 

D7 

9,    GND 

9, 

GEN* 

10,    DSO* 

10, 

DCLK 

11.    GND 

11, 

AO 

12,    DSr 

12, 

A1 

13,    GND 

13 

A2 

14. 

14, 

J 

15     GND 

15, 

GRAFVID 

16.    MOTORON* 

16. 

ENGRAF 

17     GND 

17, 

DISPEN 

18.    DiR* 

18 

VSYNC 

19     GND 

19 

HSYNC 

20,    STEP* 

20 

RESET* 

21.    GND 

21. 

WAIT* 

22.,    WD* 

22, 

H 

23,    GND 

23 

I 

24,    WG* 

24. 

IN* 

25     GND 

25 

GND 

26     DTRK0* 

26 

+  5V 

27     GND 

27, 

28,    DWPRT* 

28, 

CL166* 

29     GND 

29 

GND 

30     DRRD* 

30 

+  5V 

31     GND 

31, 

GND 

32.    SDSEL 

32, 

+  5V 

33,    GND 

33, 

GND 

34. 

34 

+  5V 

Pin 

Signal 

No. 

1, 

GND 

2 

VOUT 

3 

GND 

4, 

VERTSYNC* 

5. 

GND 

6, 

HORZSYNC 

7 

8 

9. 

10. 

11. 

12 

13, 

14. 

15. 

16, 

17 

18 

19. 

20, 

21 

22 

23 

24, 

25, 

26, 

27 

28 

29, 

30. 

31, 

32. 

33 

34 
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SECTION  V 


CHIP  SPECIFICATIONS 
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CHIP  SPECIFICATIONS 
4P  4  GATE  ARRAY 


4P GATE  ARRAY 


Motorola 

Motorola 

Motorola 

Motorola 

MC6835 

MC  6835 

MC  6835 

MC  6835 

Western  Digital 

Western  Digital 

Western  Digital 

BR  1943 

BR  1943 

BR  1943 

(BR  1941  L) 

FD  1793 

TR  1865 

TR  1865 

(WD  179X) 

FDC9216 

WD  1773 

WD  1773 

TR  1865 

WD  1943-00 

MATRA 

MATRA 

MMI 

MMI 

Timing  A.  (4.1.1) 

Timing  A.  (4.1.1) 

PAL  16RGA{166) 

PAL  16RGAST. 

Address  A.  (4,2.0) 

Address  A.  (4.2,0) 

PAL  10L8  (208) 

PAL10L8  V.T. 
PAL  10L8C.T. 

Video  A.  (4.3.0) 

Video  A.  (4.3.0) 

PAL  16L8  (268) 

PAL  16L8  MeMep 

VTI 

VTI 

PAL  16L8  (368) 

PAL  16L8  Page  Mep 

FDCA,  (4.4,0) 

FDC  A.  (4.4.0) 

RS-232  A.  (4.5.0) 

RS-232  A.  (4.5.0) 

Zitog 

Zilog 

Zilog 

Zilog 

280  A 

280  A 

280  A 

280  A 
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ARRAY*:     4.1.1 

CIRCUIT  NAME:      System  Timing 

NO.  OF  PINS:      24 

MAX.  CLOCK  FREQ.:      20.2752  MHz 

OPERTEMP.:      0°  C  to  70°  C 

OPERATING  VOLTAGE  &  RANGE:      5  V  ±  5% 
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20.2752 

MHZ 

r,T?VCT"7\  T 


1.2672MHZ 


C 


PLL 
NE5  64 


12.672MHZ 


1.2672MHZ 
FAST    ►*" 


§#6  4  *   e»= 
MODS  EL  g» 

MAC    •*■ 


OSC, 

m 


16 


IT 


10 


-*-  PCLK 

-*=-  RS2  32CLK 


-»-  SHIFT* 
-m~  XADR7* 
-►  CRTCLK 
-**=  LOADS* 
-^-  DDT* 
-•»  LOAD* 
-»-  DCLK 

-».     i 


24  PIN  CHIP 
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XTALjB' 

® 

V 

XTAL1 

© 

1.2M16 

© 

12M 

© 

1 .  2ML0T 

© 

FAST 

© 

8#64* 

© 

4.1.1 

MODS EL 

© 

MA0f 

© 

N.C. 

© 

J 

@ 

GND 

® 

(24)  VCC 

@  PCLK 

(22)  RS232CLK 

@  SHIFT* 

@  XADR7* 

@  CRTCLK 

@  LOADS* 

(17)  DOT* 

@  LOAD* 

@  DCLK 

@  H 

@  * 
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SYSTEM  TIMING  SPECS 


JMBER 
1 

PARAMETER 
20M  Cycle  Time 

MIN. 

2 

20M  Puise  Width  {High} 

20 

3 

20M  Pulse  Width  (Low} 

20 

4 

10M  Cycle  Time 

5 

10M  Pulse  Width  {High} 

45  40 

6 

10M  Pulse  Width  (Low) 

45  40 

7 

RS232CLK  Cycle  Time 

8 

RS232CLK  Pulse  Width  {High) 

92 

9 

RS232CK  Pulse  Width  (Low) 

92 

10 

PCLK*  {Fast}  Cycle  Time 

11 

PCLK*  (Fast)  Puise  Width  (High) 

110 

12 

PCLK*  (Fast)  Pulse  Width  (Low) 

110 

13 

PCLK*  (/Fast)  Cycle  Time 

14 

PCLK*  {/Fast)  Pulse  Width  {High) 

180 

15 

PCLK*  {/Fast}  Pulse  Width  (Low) 

180 

16 

PCLK*  Rise  Time 

17 

PCLK*  Fall  Time 

Input  Voltage  Level  {High) 
input  Voltage  Level  (Low) 
Output  Voltage  Level  (High) 
Output  Voltage  Level  {Low} 


13 

ns 

13 

ns 

DC  CHARACTERISTICS  {ALL  PINS) 

2.0 

V 

.8 

V 

2.8                          3.5 

V 

35 

,5 

V 

(ALL  PINS  EXCEPT  CRTCLK  OUTPUT) 


Input  Current  Level  (High) 
Input  Current  Level  (Low) 
Output  Current  Level  (High) 
Output  Current  Level  (Low) 


-160 
3,2 


40 

jia 

-16 

ma 

jua 

ma 

Output  Current  Level  (High) 
Output  Current  Level  {Low} 


(CRTCLK  OUTPUT) 

-400 


Ida 
ma 
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T 
© 


rJ    T 


J 


S    Tl — T 


© 


SfeP     J 


i    i   L 


o 

H 


S 

w 

Eh 
en 


2 
4* 


B 

CO 

■K 

Ui 

< 

& 

< 

fcl 

A 

fo 

CN 

•K 

ro 

t^ 

M 

<N 

a 

CJ 

CO 

U 

u 

05 

cn 

p* 

6^ 


t4 
u 


Cm 


i*5 

o 

0< 
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VIDEO  TIMING  SPECS 


10.1376  MHz 

12,672  MHz 

NUMBER 

PARAMETER 

MIN. 

TYP,             MAX,, 

Mll\L 

TYP. 

1 

VCLK  Cycle  Time 

98.6 

78  9 

2 

VCLK  Pulse  Width  (High) 

40 

30 

3 

VCLK  Pulse  Width  {Low) 

40 

30 

4 

DCLK  Cycle  Time 

986 

789 

5 

DCLK  Pulse  Width  {High) 

40 

30 

6 

DCLK  Pulse  Width  {Low} 

40 

30 

7 

DOT  Cycle  Time 

98.6 

78.9 

8 

DOT  Pulse  Width  {High) 

40 

30 

9 

DOT  Pulse  Width  {Low) 

40 

30 

10 

DCLK  I  to  DOT  t 

5 

11 

DCLK  tto  H,  I,  J  11 

27 

12 

H  Cycle  Time 

197  2 

157,8 

13 

H  Pulse  Width  (High) 

90 

70 

14 

H  Pulse  Width  (Low) 

90 

70 

15 

I  Cycle  Time 

394.4 

315.6 

16 

I  Pulse  Width  (High) 

190 

150 

17 

I  Pulse  Width  (Low) 

190 

150 

18 

J  Cycle  Time 

788  8 

631  2 

19 

J  Puise  Width  (High) 

385 

305 

20 

J  Pulse  Width  (Low) 

385 

305 

21 

SHIFT  Cycle  Time 

(64x16  &  80x24  Mode) 

98.6 

78.9 

(32x16  &  40x24  Mode) 

197  2 

1578 

22 

SHIFT  Pulse  Width  (Low) 

30 

30 

23 

SHIFT  tto  LOADS  i 

0 

27* 

0 

24 

LOADS  tto  SHI  FT  t 

50* 

50* 

25 

LOADS  Pulse  Width  (Low) 

70 

98  6 

70 

78.9 

26 

LOADS!  to  SHIFT! 

50* 

50* 

27 

LOADS  Cycle  Time 

(64x16  8(80x24  Mode) 

788.8 

6312 

(32x16  &  40x24  Mode) 

1577.6 

1262.4 

28 

SHIFT  tto  LOAD  t 

5 

29 

LOAD  Pulse  Width  (Low) 

40 

30 

30 

LOAD  Cycle  Time 

{64x16  &  80x24  Mode) 

788.8 

6312 

{32x16  &40x24  Mode) 

1577.6 

1262.4 

31 

LOAD  tto  CRTCLK  I 

0 

27 

0 

32 

CRTCLK  Cycle  Time 

7888 

6312 

33 

CRTCLK  Pulse  Width  (High) 

385 

305 

34 

CRTCLK  Pulse  Width  {Low) 

385 

305 

35 

CRTCLK  U  to  XADR7  It 

5 

36 

XADR7  Cycle  Time 

788  8 

631.2 

37 

XADR7  Pulse  Width  (High) 

385 

305 

38 

XADR7  Pulse  Width  (Low) 

385 

305 

MAX.         UNITS 
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m 

tO   CtD 

z 

Q  Q 

M 

O  O 

5s! 

s  s 

m 

E-t 

*£>  ^r 

rH    CM 

<) 

Ixj 

X  X 

Q 

H 

■ef  o 

> 

*£>  CO 

^      . 

a 

R 

U  O 

O 

O 

>   rH 

Q 

Q 
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J  u 


L 


J 


s 

3 
3 

3 
3 
3 
J 


"D 


W  CO 

Q  Q 

O  O 

s  s 

vis  "ia* 


r  i 


TP  J  P 


"^r 


P 


U  o 

>  H 


Q 

Q 

a 

<C 

< 

E-t 

O 

O 

a; 

iJ 

J 

O 
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4.1 

PIN  SIGNAL 

23  PCLK 

22  RS232CK 

21  SHIFT* 

20  XADR7* 

19  CRTCLK 

18  LOADS* 

17  DOT* 

16  LOAD* 

15  DCLK 

14  H 

13  I 

11  J 


MAX. 

CAPACITANCE 

35  pf 

105  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 
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ARRAY  #:      4.2.1 

CIRCUIT  NAME:    Address  Decode 

NO.  OF  PINS:     40 

MAX.  CLOCK  FREO.:      4  MHz 

OPER.TEMP.:      0°  C  to  70°  C 

OPERATING  VOLTAGE  &  RANGE:   5±  5% 
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4-5V 


MI 

IOREQ 

RD 

WR 

MREQ 

RFSH 


DESPAGE  &— 

EN  PAGE  &*~ 

SRC  PAGE  **~ 

SEL1  ^*- 

SEIvff  ^»~ 


SIXTN  IB- 
MOD  4  P  &»~ 


IN* 
OUT* 
MRD* 
MWR* 


-&~  RASENJ0<* 

*~  RASENl* 

*»-  MAPA15 

^  RAMBUSDIR 

>-  RAMBUS EN* 

*-  RAMRDEN/MCYCEN  (RAMRDMCYC) 

*»*  RAMWREN/ROMB* 


~«»*  BUSDIR* 
-^-  BUSEN* 


■*►  VIDEO* 
-*»  KEYBD* 
-&**  ROMCE*/ROMC* 

-®^  LPRQ* 

^.  ROM* /ROMA* 
(I/O) 


4#  PINS  USED 
4^  PIN  CHIP 

4.2.J8f 

ADDRESS  DECODE 
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Ml 

IOREQ 

RD 

WR 

MREQ 


A15 
A14 
A13 
A12 

Jt\  JL  JL 

Aior 

LPADD 

LPRQ* 

DESPAGE  Oj) 

EN PAGE  @ 

SRC PAGE  @ 

SEL1   © 
SEL# 

GND 


© 

© 
© 
© 
© 

© 

® 

© 
® 

© 
© 
© 


V 


4.2.1 


@  VEC 

@  IN* 

(38)  OUT* 

@  MRD* 

(36)  MOD4P 

(S^>  MWR* 

(34)  RASENtf* 

@  RASENI* 

(32)  MAPA15 

(y$\   RAMBUSDIR 

(30)  RAMBUSEN* 

(29)  RAMRDEN/MCYCEN 

@  RAMWREN/ROMB* 

(27)  BUSDIR* 

@  BUSEN* 

@  SIXTN 

Q  VIDEO* 

(23)  KEYBD* 

(Q  ROMCE*/ROMC* 

(21)  ROM*/ROMA* 
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SIGNAL  NAME 
MDD4P 


MODEL  A  MODE 
"l"  =  +SV 


MODEL  4  MODE 
"0"=GND 


Ml 

IOREQ 

RD 

WR 

MREQ 

RFSH 

DESPAGE 

ENPAGE 

SRCPAGE 

SEL1 

SEL0 

A15 

A14 

A13 

A12 

All 

A10 

LPADD 

SIXTN 

IN* 

OUT* 

MRD* 

MWR* 

RASEN0* 

RASEN1* 

MAPA15 

RAMBUSDIR 

RAMBUSEN* 

(RAMRDMCYC)  RAM  RDEN/MCYCEN 

RAMWREN/ROMB* 

BUSDIR* 

BUSEN* 

VIDEO* 

KEYBD* 

ROMCEVROMC* 

LPRQ* 

R0M7R0MA* 

I    -  INPUT 
O  =  OUTPUT 


Mi 

IOREQ 

RD 

WR 

MREQ 

RFSH 

DESPAGE 

ENPAGE 

SRCPAGE 

SEL1 

SEL0 

A15 

A14 

A13 

A12 

A11 

A10 

LPADD 

SIXTN 

IN* 

OUT* 

MRD* 

MWR* 

RASEN0* 

RASEN1* 

MAPA15 

RAMBUSDIR 

RAMBUSEN* 

RAMRDEN 

RAMWREN 

BUSDIR* 

8USEN4P* 

VIDE04P* 

KEYBD4P* 

ROMCE* 

LPRQ* 

ROM* 


Ml 

IOREQ 

RD 

WR 

IOREQ 

RFSH 

DESPAGE 

ENPAGE 

SRCPAGE 

SEL1 

SEL0 

A15 

A14 

A13 

A12 

A11 

A10 

LPADD 

SIXTN 


IN* 

OUT* 

MRD* 

MWR* 

RASEN0* 

RASEN1* 

MAPA15 

RAMBUSDIR     0 

RAMBUSEN*     0 

MCYCEN  0 

ROMB* 

BUSDIR* 

DAT AC NT* 

VIDE04* 

KEYBD4* 

ROMC* 

LPRQ* 

ROMA* 
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PARAMETER 

1 

lOREQti  *  RD  tl  to  IN  It 

2 

lOREQti  *  WR  tito  OUT  It 

3 

RD  tltoMRD  it 

4 

WR  tito  MWR  it 

5 

A15  tito  RASEN0  ti 

6 

A15  tito  RASEN1  ti 

7 

A15  titoMAPA15  ti 

8 

RD  it  to  RAMBUSDIR  it 

9 

MREQtito  RAMBUSEN  it 

10 

A15-A10  ti  to  RAMRDMCYC  ti 

11 

A15-A14  ti  to  RAMWREN  ti 

12 

MREQtito  ROMB  it 

13 

iOREQtitoBUSDIR  it 

14 

RD  titoBUSDIR  it 

15 

MREQ  titoBUSEN  it 

i6 

ivincui  i>  i.u  v  iucu  +  i 

17 

MREQtito  KEYBD  it 

18 

MREQtito  ROMCE  it 

19 

MREQtito  ROMC  it 

20 

MREQtito  LPRQit 

21 

MREQtito  ROMA  It 

22 

PCLK  ti  to  PCLK  it 

23 

PCLK  Cycle  Time 

24 

PCLK  ttoM1  t 

25 

PCLK  itoMREQt 

26 

A10-A15  tito  MREQ  t 

27 

PCLK  ito  RD  t 

28 

PCLK  tto  A10-A15  ti 

29 

PCLK  tto  A10-A15  ti 

30 

PCLK  tto  Ml  1 

31 

PCLK  tto  MREQ  I 

32 

MREQ  itoMREQt 

33 

PCLK  tto  RD  i 

34 

PCLK  tto  RFSH  t 

35 

RFSH  ti  to  RASEN  0  or  RASEN1  ti 

36 

PCLK  Ito  MREQ  I 

37 

MREQ  Pulse  Width  (High) 

38 

PCLK  tto  RFSH  1 

39 

A1-A9  tito  LPADD  ti 

40 

PCLK  itoWR  ti 

41 

PCLK  ito  RD  i 

42 

Control  Lines  tito  Affected  Signals  ti 

43 

A0-A15  tito  lOREQt 

44 

PCLK  tto  IOREQ  t 

45 

PCLK  tto  RD  t 

46 

PCLK  ttoWR  t 

SPECS 
MIM     TYP 


110 


50 


110 


220 


200 


123 
246 


MAX, 

35 
35 
35 
35 
50 
50 
50 
35 
35 
50 
50 
35 
35 
35 
50 
35 
35 
35 
35 
35 
35 


91 

101 
128 
128 
136 
91 

91 

136 

35 

91 

126 


86 
91 
35 

81 
91 
71 


UNITS 
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DC  CHARACTERISTICS  (ALL  PINS)  0°  -  70°  C 

PARAMETER  MIM.  TYP.  MAX.  UNITS 

Input  Voltage  Level  (High)  2„0  V 

Input  Voltage  Level  (Low)  g  y 

V 


V 


Output  Voltage  Level  (High)  2  7  3,5 

Output  Voltage  Level  (Low)  „35  5 

(ALL  PINS  EXCEPT  OUT*,  RAMRDEN/MCYCEN) 

Input  Current  Level  (High)  20  ua 

Innut  OiMTpnt  i  p^p|  (\  nw)  * 

~  ■-*  ma 

Output  Current  Level  (High)  -200  „a 

Output  Current  Level  (Low)  4  ma 


(OUT*,  RAMRDEN/MCYCEN) 

Output  Current  Level  (High)  -400 

Output  Current  Level  (Low)  8  ma 
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PIN  SIGNAL 

39  IN* 

38  OUT* 

37  MRD* 

35  MWR* 

34  RASEN0* 

33  RASEN1* 

32  MAPA15 

31  RAMBUSDIR 

30  RAMBUSEN* 

29  RAMRDEN/MCYCEN 

28  RAMWREN/ROMB* 

27  BUSDIR* 

26  BUSEN* 

24  VIDEO* 

23  KEYBD* 

22  R0MCE7R0MC* 

(OUTPUT)    21  ROMA* 

14  LPRQ* 


MAX„ 

CAPACITANCE 

35  pf 

35  pf 

35  pf 

128  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 

35  pf 
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ARRAY  #:     4.3.0 

CIRCUIT  NAME:      Video  Support 

NO.  OF  PINS:     40 

MAX.  CLOCK  FREQ.:      12.672  MHz 

OPER.TEMP.:   0°Cto70°C 

OPERATING  VOLTAGE  St  RANGE:      5±  5% 
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+5V 


SRD#  >- 

SRD1  P* 

SRD2  $**» 

SRD3  *• 

SRD4  *■ 

SRD5  *■ 

SRD6  ^ 

SRD7  »» 


DISPEN  *- 

RA2  ► 

RA3  ►> 

DLYCHAR  .* 

DLYCHAR*  -^ 

CGA3  -* 

CGA4  -<* 

CGA5  -^ 

CGA6 

CGA7 

CGA8 

CGA9 


S#- 


CGA1J0T  -«- 


39  PINS  USED 
40  PIN  CHIP 

4.3  .j8T 


VOUT* 


«*  INVERSE 
«*  ENALTSET 


«*  LOAD* 
•m     LOADS  * 
-«  SHIFT* 


-*  ENGRAF 
-«  GRAFVID 
-«  CL166* 


«■  CGD^T 

«  CGDl 

<*  CGD2 

«  CGD3 

<  CGD4 

*  CGD5 

«  CGD6 

m  CGD7 


VIDEO  SUPPORT 
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CGA7 

i 

CGA8 

2 

CGA9 

3 

CGKltf 

4 

SRD7 

5 

SRD6 

6 

SRD5 

7 

SRD4 

8 

SRD3 

9 

SRD2 

10 

SRD1 

11 

SRDO 

12 

DLYCHAR* 

13 

DLYCHAR 

14 

DISPEN 

15 

CL166* 

16 

ENGRAF 

17 

GRAFVID 

18 

VOUT  * 

19 

GND 

20 
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PARAMETER 


2* 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

20** 
21 
22 

23** 
24* 
25 
26* 
271 
28 
29 
30 
31 
32 


SRD0-SRD7  U  to  LOAD  t      

Inputs  D0-D7  of  LS273  U  to  LOAD  t 

LOAD  f  toCGA3~~CGA10  U 

R  A2,  R  A3  H  to  Outputs  of  LS1 53  U 

Inputs  CGA3-CGA10of  LS153  14  to  Outputs  H 

DLYGRAPHIC  i  to  Outputs  of  LS244  U 

DLYGRAPHIC  t  to  Outputs  of  LS244  Tristate 

ENALTSET  U  to  CGA9  U 

INVERSE  U  to  inputs  D7  of  LS273  U 

INVERSE  14  to  INVDISPEN,  CHAR  H 

INVERSE  Hto  Input  to  51  H 

SRD6  U  to  CHAR  H 

DISPEN  Uto  Input  D0 of  LS175  U 

DISPEN  tlto  INVDISPEN  U 

ENGRAF  Uto  INVDISPEN  ti 

ENGRAF  f  I  to  Inputs  of  51  U 

GRAFVID  Uto  Input  of  51  U 

CGD0-CGD7  U  to  LOADS  4-  &  SHIFT  f 

RA3  UtoDLYBLANK  U  0 

LOADf  to  DLYBLANK  ti  0 

LOADS  I  to  SHIFT  f 

SHFT/LD-l  to  SHIFT  t 

CL166  tltoQH  U 

LOAD  t  to  SHIFT  t 


MIN. 


61 
20 


TYP. 


27 
27 
50 
30 


LOAD  tto  VIDE02  U-  SHIFT  t  to  VIDEO]  H 
GRAFVID  fito  VIDE02  U 
VIDE02  U,  VIDEO!  Uto  VOUT  U 
ENGRAF  Hto  VIDE02  U 
DLYCHAR*  tto  CGD0-CGD7  Tristate 
CRTCLK  |  to  DISPEN 


SPECS 

MAX„ 


60 
38 
30 
30 
30 
35 
35 
40 
20 
40 
20 
40 
40 
20 
5 


UNITS 


50 
50 


30 

±  5 

±  5 

15 

20 

15 

150 


t  The  delay  from  LOAD  f  to  VIDE02  U  should  equal  the  delay  from  SHIFT  f  to  VIDE0 1  U, 
Specs  required  for  TLL  components-can  be  changed  to  meet  the  setup  &  hold  time  specs  of  array  logic 
** Specs  provided  are  for  reference,  timing  is  from  external  logic 
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DC  CHARACTERISTICS  (ALL  PINS)  0°  -  70°  C 

PARAMETER  M|Nt  Typ  ^ 

Input  Voltage  Level  (High)  2.0 

Input  Voltage  Level  (Low) 

8 

Output  Voltage  Level  (High)  2.7  3  5 

Output  Voltage  Level  (Low)  35 


UNITS 

V 
V 
V 
V 


20 


Input  Current  Level  (High) 
input  Current  Level  (Low) 

Output  Current  Level  (High)  -200 

Ma 
Output  Current  Level  (Low)  4 

ma 


jua 
4  ma 
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4,3 


MAX. 

PIN  SIGNAL  CAPACITANCE 

4  CGA10  35  pf 

3  CGA9  35  pf 

2  CGA8  35  pf 

1  CGA7  35  pf 

39  CGA6  35  pf 

38  CGA5  35  pf 

37  CGA4  35  pf 

36  CGA3  3b  pt 

13  DLYCHAR*  35  pf 

14  DLYCHAR  35  pf 
19  VOUT*  35  pf 
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ARRAY  #:     4.4,0 

CIRCUIT  NAME:  Floppy  Disk  Support 

NO,  OF  PINS:      24 

MAX,  CLOCK  FREQ„:      8  MHz 

MAX.  PROP,  DELAY  THROUGHPUT:     75  ns 

OPER.TEMP:      0°Cto70°C 

OPERATING  VOLTAGE  &  RANGE:      5V±  5% 
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4.4.J8 


Dl 
D2 
D3 
D5 
D6 
D7 

RESET*  gs» 

WRNMI*  9- 

RDNMI*  ft» 

DRVSEL*  »» 

INTRQ 

DRQ 

WG 


8MHZ 
ENP/RDY 

MOTORON 
EXTSEL 

NMI 
WAIT 


16MHZ 
XTAL 


24  PIN  CHIP 


FLOPPY  DISK  SUPPORT 
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INTRQ 

© 

DRQ 

© 

NP/RD^ 

f® 

WG 

© 

DO 

© 

Dl 

© 

D2 

© 

D3 

© 

D5 

© 

D6 

© 

D7 

© 

GND 

(E) 
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PARAMETER  MIM 

1.  Data  Setup  Time  560 

2 
3 
4 
5 
6 
*7 
8 


Data  Hold  Time  50 

Reset*  Puise  Width  70                             100 

Reset*  I  to  Wait  or  NM!  I  75 

WRNMl*  f  to  74LS74Q's  Outputs  It  75 

DRVSEL*  ItoMOTORON  t  75 

MOTORON  Puise  Width  (Low)  3                          4                                 5 

DRVSEL*  I  to  WAIT  t  75 

DRVSEL*  ItoCLRWAIT  t  500                                                        1100 

10                        DRVSEL*  4  to  WAITIMOUT  t  1024                                                      1050 

11,  DRVSEL*  tto  ENP/RDY  tl  75 

12,  DRVSEL*  tto  EXTSEL  11  75 
13  INTRO  t  or  DRQ  tto  WAIT  4  75 
i4                           iiviTRQ  i  ui  DRQ  !  lu  CLnWAIT  +  7G 

15.  INTRO  torDROf  toWAITlMOUT  I  75 

16.  8  MHZ  Cycle  Time  125 

17.  8  MHZ  Pulse  Width  (Low)  50                        62.5 

18.  8  MHZ  Pulse  Width  (High)  50                        62.5 

19.  WG  H  to  ENP/RDY  U  75 
20,.  RDNMI*  4  to  D0,  D5-D7  Valid  75 
21.                        RDMMI*  tto  DO,  D5-D7  Tristate  0  75 


MOTORON  Circuit  Must  Simulate  a  Retriggerable  Monostable  Multivibrator  (74LS123) 
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CAPACITANCE  LOAD 

OUTPUT 

CAPACITANCE  MAX. 

D0 

80  pf 

D5 

80  pf 

D6 

80  pf 

D7 

80  pf 

8  MHZ 

15  pf 

ENP/RDY 

15  pf 

MOTORON 

15  pf 

EXTSEL 

15  pf 

NMI 

15  pf 

WAIT 

15  pf 
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PARAMETER 


r*w  /"»Ut  a  n>  a  r-- 


/"»Ut  a  r»  a  rv-rr"  r>  tr»' 


I  IV>0  V     —   /  V     <L- 


{ALL  PINS) 


MIN. 


TYP. 


MAX. 


UNITS 


Input  Voltage  Level  (High) 
Input  Voltage  Level  (Low) 
Output  Voltage  Level  (High) 
Output  Voltage  Level  (Low) 


2,0 


2,7 


3,5 
,35 


.5 


V 
V 
V 
V 


Input  Current  Level  (High) 
Input  Current  Level  (Low) 
Output  Current  Level  (High) 
Output  Current  Level  (Low) 


(ALL  PINS  EXCEPT  MOTORON  &  D0,  D5-D7) 


-160 
3.2 


20 

fia 

-A 

ma 

jua 

ma 

Output  Current  Level  (High) 
Output  Current  Level  (Low) 


MOTORON 


-240 
4.8 


Ma 
ma 


Input  Current  Level  (High) 
Input  Current  Level  (Low) 
Output  Current  Level  (High) 
Output  Current  Level  (Low) 


D0   D5.D7 


-280 
5.6 


20 

Ma 

•A 

ma 

fia 

ma 
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ARRAY  #:      4.5.0 
CIRCUIT  NAME:      RS232  Support 
NO.  OF  PINS:      40 
OPER.TEMP.:      0°Cto70°C 
OPER.  VOLTAGE:      5V±  5% 
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vcc 


AO 

1 

4.5.0 
40  PIN 

9 

RTS 

Al 

2 

10 

DTR 

3 

7 

RDINTSTATUS 

SRTS 

4 

8 

WRINTMASKREG 

ENTD 

5 

21 

RS232IN 

0UTE8 

6 

38 

RS2320UT 

0UTE9 

14 

11 

CTS 

OUTEA 

15 

23 

DSR 

OUTEB 

16 

18 

CD 

INEB 

RI 

20 

37 

13 

RD 

INT 

PE 

26 

27 

FE 

25 

BD# 

DE 

24 

28 

BDl 

THRE 

22 

29 

BD2 

DR 

19 

30 

BD3 

RTCIN 

36 

31 

BD4 

XINT 

35 

32 

BD5 

WR 

3  9 

33 

BD6 

N.  C. 

11 

34 

BD7 

TT 


Hardware  190 


to 

t 

z 

> 

> 

> 

> 

to 

=1 

CO 

E 

TO       TO      TO      TO 

=t  a.  =t  =t 

TO      TO     TO      ro 

E    E    E    E 

D 

X 

< 

aq 

ur> 

OJ 

j* 

£ 

a." 

ID 

in 

> 

ci 

CO 

2 

GJ 

r-t 

©  ©  ©  © 

CM    ©    CO    «sf 

s 

cm 

CN 

CM    CM    00    CM 

r~     r~     CM     t~ 

CO    00    tn    <sT 

1        1        1        1 

Q   Q 

a§ 

OQ    Q 

CO   Q 

*    o 

c?j     o 

ICO 

uu  o" 

7       •    CO 

jCQ    O 

i°3 

..  CO  |CQ 

feteSE 

z  z  Q  z: 
1—  l_  co  Ir: 

a 

at 

a 

o 

0J 

X 

Q 

a> 

X 

cu 

"ro 

~ 

TO 

i 

-J 

X 

o 

o 

X 

_J 

X 

-J 

> 

> 

> 

> 

J? 

_o 

sz 

1 

o 

o 

J~ 

o 

3 
DO 

1 

o 

tj) 

X 

_j 

en 

x 

_J 

ir 

_j 

X 

_J 

0) 

cu 

cu 
en 

CD 

en 

to 

en 

TO 

c 

c 

c 

c 
ai 

to 

ra 

O) 

a; 

_ 

o 

O 
> 

o 

> 

3 

3 

3 

a 

3 

> 

> 

+-• 

+J 

o 

u 

+_* 

3 

3 

3 

a, 

3 

CL 

3 

13 

3 

3 

a 

CL 

Q. 

3 

3 

Q. 

Q. 

3 

C 

c 

o 

O 

C 

C 

o 

O 

Hardware  191 


X 

< 


|Q 
lac 


z 


lu 


H 
>- 


LU 

a 


o 


CD 
Q 


£ 


CQ 
Q 


|_ 
3 
O 


O 


o 

CO 
LU 

j_ 

O 


(CO 

H 

lo 

K 

z 

o 

X 

a 

UJ 

,. 

o 

tn 

z 

LO 

z 

o 

it 

c 

l_ 

X 

>- 

or 

s 

cc 

t- 

a 

Q 

D 
O 

zz 

LU 

o 

< 

cc 

x 

CL) 

l_ 

x: 

LU 

o 

a 

"Ja 

LU 
U_ 

|0Q 

LU 

LU 

|z 

a. 

63 

3 

i|_- 

CQ 

Q 

QQ 


D 
O 

o 


Hardware  192 


AO-Al 


VALID 


Tl 
T2 


WRINTIMASKREG, 
RDINTSTATUS, 


RS232IN,  RS2320UT 


WR 


BDBUS 
(OUT) 


BDBUS 
(IN) 


OUTXX 
OUTXX 


T3 
T4 


T5 


-I    v- 


I 


T6 


T13 


-J   <- 


■?   *" 


^  i- 


VALID 


^ ^ 


T12 
Til  - 


-\     h 


VALID 


T7 
T8 


T10-&- 


T9 


VALID 


Hardware  193 


MIN. 

TYP. 

MAX. 

tl 

168 

*2 

168 

t3 

-34 

0 

t4 

-34 

0 

t5 

75 

t6 

75 

t7 

34 

t8 

60 

tg 

24 

250 

tio 

24 

250 

tn 

75 

tl2 

75 

tl3 

75 

t14 

32 

{Need  18) 


All  Timing  in  NSEC. 
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Advance  Information 


CRT  CONTROLLER  (CRTC) 

The  MC6835  is  a  ROM  based  CRT  Controller  which  interfaces  an 
MPU  system  to  a  raster  scan  CRT  display.  St  is  intended  for  use  in  MPU 
based  controllers  for  CRT  terminals  in  stand-alone  or  cluster  configura- 
tions The  MC6835  supports  two  selectable  mask  programmed  screen 
formats  using  the  program  select  input  (PROG) 

The  CRTC  is  optimized  for  the  hardware/software  balance  required 
for  maximum  flexibility  All  keyboard  functions,  reads,  writes,  cursor 
movements,  scrolling,  and  editing  are  under  processor  control  The 
mask  programmed  registers  of  the  CRTC  are  programmed  to  control 
the  video  format  and  timing 
®  Cost  Effective  ROM  Based  CRTC  Which  Supports  Two  Screen 

Formats 
O  Useful  in  Monochrome  or  Color  CRT  Applications 
*  Applications  Include  "Glass-Teletype."  Smart.  Programmable,  intel- 
ligent CRT  Terminals;  Video  Games;  Information  Displays 
®  Alphanumeric,  Semigraphic.  and  Full  Graphic  Capability 
®  Timing  May  Be  Generated  for  Almost  Any  Alphanumeric  Screen 

Format,  eg  .80x24,  72x64,  132x20 
®  Single  +5  Volt  Supply 
®  M6800  Compatible  Bus  Interface 
®  TTL-Compatibie  Inputs  and  Outputs 
®  Start  Address  Register  Provides  Hardware  Scroll  (By  Page,  Line,  or 

Character) 
©  Programmable  Cursor  Register  Allows  Control  of  Cursor  Position 
©  Refresh  (Screen)  Memory  May  Be  Multiplexed  Between  the  CRTC 

and  the  MPU  Thus  Removing  the  Requirements  for  Line  Buffers  or 

External  DMA  Devices 
©  Mask  Programmable  interlace  or  Non-lnterlace  Scan  Modes 
«  14-Bit  Refresh  Address  Allows  Up  to  16K  of  Refresh  Memory 

for  Use  in  Character  or  Semigraphic  Displays 
©  5-Bit  Row  Address  Allows  up  to  32  Scan-Line  Character  Blocks 
©  By  Utilizing  Both  the  Refresh  Addresses  and  the  Row  Addresses, 

a  51 2K  Address  Space  is  Available  for  Use  in  Graphics  Systems 
©  Refresh  Addresses  are  Provided  During  Retrace.  Allowing  the  CRTC 

to  provide  Row  Addresses  to  Refresh  Dynamic  RAMs 
©  Pin  Compatible  with  the  MC6845  The  MC6B45  May  Be  Used  as  a 

Prototype  Part  to  Emulate  the  MC6835 


MAXIMUM  RATINGS 


Rating 

Symbol 

Value 

Unit 

Supply  Voltage 

vCc* 

-0.3  to  +7.0 

V 

Input  Voltage 

Vin" 

-0.3  to  +7.0 

V 

Operating  Temperature  Range 
MC6835.  MC68A35.  MC68835 
MC6835C,  MC68A35C,  MC68B35C 

TA 

0  to  +70 
-  50  to  +85 

°c 

Storage  Temperature  Range 

Tsig 

-55  to  +150 

°c 

"With  respect  to  GND  (Vgs) 


MC6835 


MOS 

(HIGH-DENSITY,  N-CHANNEL, 
SILICON-GATE  DEPLETION  LOAD) 

MASK  PROGRAMMED 

CRT  CONTROLLER 

(CRTC) 


L  SUFFIX 

CERAMIC  PACKAGE 
CASE  715 


S  SUFFIX 

CERD1P  PACKAGE 
CASE  734 


P  SUFFIX 

PLASTIC  PACKAGE 
CASE  7!! 


GNDt  ! 
RESET[  2 
PROGt  3 
MA0[  A 
MAl£  5 
MA2[  6 
MA3[  ■} 
MA4[  8 
MA5t  9 
MA6t 
MA7[ 
MA8[ 
MA9[ 
MAlOt 
MA11[ 
MA12£ 
MA13[ 
DEE  I 
CURSOR! 1 

vccE: 


vt  ASSIGNMENT 


38 


10 


14 


16 


]VS 

3HS 
3  RAO 
37  1RA1 
36  ]RA2 
35  ]RA3 
34  1RA4 
33  ]D0 
32  301 
31  T.D2 
30  ]D3 
29  ]D4 
28  3D5 

]D6 
26  3D7 
25  3CS 

3RS 

3E 

3w 

3CLK 


n 


24 


22 
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FIGURE  1  -  TYPICAL  CRT  CONTROLLER  APPLICATION 
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THERMAL  CHARACTERISTICS 


Characteristic 

Symbol 

Value 

Rating 

Thermal  Resistance 
Plastic 
Cerdip 
Ceramic 

"J  A 

100 
60 
50 

°C/W 

RECOMMENDED  OPERATING  CONDITIONS 


Characteristic 

Symbol 

Min 

Typ 

Max 

Unit 

Supply  Voltage 

vcc 

475 

5.0 

5.25 

V 

Input  Low  Voltage 

VlL 

-0.3 

_ 

0.8 

V 

Input  High  Voltage 

V|H 

2.0 

~ 

VCC 

V 

This  device  contains  circuitry  to  protect  the  in- 
puts against  damage  due  to  high  static  voltages 
or  electric  fields;  however  it  ts  advised  that  nor- 
mal precautions  be  taken  to  avotd  application  of 
any  voltage  higher  than  maximum  rated  voltages 
to  this  high-impedance  circuit  for  proper  opera- 
tion it  is  recommended  that  Vtn  and  Vout  be  con- 
strained to  the  range  Vss(^vm  of  vout'^vCC 
Reliability  of  operation  is  enhanced  if  unused  in- 
puts are  tied  to  an  appropriate  logic  voltage  level 
(eg  ,  either  Vss  or  Vqc1 


POWER  CONSIDERATIONS 

The  average  chip-junction  temperature.  Tj..  in  °C  can  be  obtained  from; 

Tj  =  Ta  +  (PD^JA»  n) 

Where: 

Ta=  Ambient  Temperature,  °C 

0JA=  Package  Thermal  Resistance.  Junctiorwo-Arnbiem,  °C/W 
PD-PINT+PPORT 

PjNT-'CC*  VCC  Watts  -  Chip  Internal  Power 
PpORT^Port  Power  Dissipation.  Watts  -  User  Determined 
For  most  applications  PpORT^^lNT  and  can  be  neglected    PpORT  may  become  significant  if  the  device  is  configured  to 
drive  Darlington  bases  or  sink  LED  loads 
An  approximate  relationship  between  Pq  and  Tj  (if  PpORT  is  neglected)  is: 

PD=K^-(Tj  +  273°C) 
Solving  equations  1  and  2  for  K  gives: 

K  =  PD»(Ta  +  273°C)+0ja»PD2 
Where  K  is  a  constant  pertaining  to  the  particular  part  K  can  be  determined  from  equation  3  by  measuring  PD  (at  equilibrium) 
for  a  known  T A  Using  this  value  of  K  the  values  of  Pq  and  T  j  can  be  obtained  by  solving  equations  ( 1 )  and  (2)  tterattvely  for  any 
value  of  Ta 


(2) 


(3) 
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DC  ELECTRICAL  CHARACTERISTICS  fVcc  =  5.0  Vdc  ±5% 

,  Vss  =  0'  Ta~0  to  70"C  unless  otherwise  noted)  (Reference  Figu 

es  2-4) 

Characteristic 

Symbol 

Min 

Typ 

Max 

Unit 

input  High  Voltage 

ViH 

2.0 

- 

vcc 

V 

input  Low  Voltage 

vlL 

-0.3 

_ 

0.8 

V 

Input  Leakage  Current 

"in 

_ 

0  1 

2.5 

jiA 

Hi-Z  (Off  State!  Input  Current  (Vcc  =  5  25  V)  IVin  =  0  4  to  2  A  V) 

ITS! 

-10 

_ 

10 

pA 

Output  High  Voltage 
U|_oad=-100fiA> 

24 

30 

- 

V 

Output  Low  Voltage  flioad^  1  6  mA1 

vol 

_ 

0.3 

04 

V 

Internal  Power  Dissipation  {Measured  at  Ta~0°C) 

Pd 

- 

150 

300 

mW 

Input  Capacitance 

D0-D7 
AH  Others 

Cjn 

_ 

„ 

12.5 

pF 

_ 

- 

10 

Output  Capacitance 

All  Output!. 

^out 

- 

_ 

10 

pF 

BUS  TIMING  CHARACTERISTICS  (Reference  Figures  2  and  31 


Idem. 
Number 

Characteristics 

Symbol 

MC6835 

MC68A35 

MC68B35 

Unit 

Min 

Max 

Min 

Max 

Min 

Max 

5 

Cycle  Ttniti 

'eye 

1  0 

10 

0  67 

10 

0  5 

10 

;js 

2 

Pulse  Width.  1   1  ow 

PWEL 

J  ■!(  i 

- 

280 

- 

210 

~ 

ns 

3 

Pulse  IVullh.  r  Hiijh 

PWEH 

450 

- 

280 

~ 

220 

- 

ns 

4 

Clock  liansilion  Tune 

ll.  M 

25 

25 

20 

ns 

9 

Address  Hold  lime  IRS) 

'AH 

10 

10 

10 

ns 

13 

RS  Setup  Bel  ore  E 

'AS 

80 

60 

40 

ns 

14 

W  and  CS  Setup  Befoie  1: 

'CS 

HP 

m 

40 

ns 

15 

Hold  Tim.;  fur  W  and  CS 

'CH 

10 

10 

10 

ns 

2! 

Write  Data  Moid  lime  Required 

'DHW 

10 

.... 

10 

10 

ns 

31 

Peripheral  Input  Data  Setup 

'OSW 

165 

... 

80 

60 

... 

ns 

E   \ 


-©- 


FIGURE  2  -  MC6835  BUS  TIMING 
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1  Voltage  levels  shown  are  VL<04  V.  Vh£2  4  V  unless  otherwise  noted 

2  Measurement  points  shown  are  0  8  V  and  2  0  V  unless  otherwise  noted 
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FIGURE  3  -  BUS  TIMING  TEST  LOAD 
p  50  V 
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f  MMD6150 
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-30  pF  lor  MA0-MA13,  HA0-RA4 
OE.  HS    VS    and  CURSOR 
FU11  kO  for  D0-D7 

=  24  kn  for  All  Other  Outputs 


CRTC  TIMING  CHARACTERISTICS  (See  Figure  41 


Characteristics 

Symbol 

MC6835 

MC68A35 

MC68B35 

Unit 

Min 

Max 

Min 

Max 

Min 

Max 

Minimum  Clock  Pulse  Width,  Low 

PWCI 

150 

140 

_ 

130 

_ 

ns 

Minimum  Clock  Pulse  Width.  High 

PWCH 

150 

- 

140 

_ 

130 

- 

ns 

Clock  Frequency 

fc 

330 

- 

300 

- 

270 

_ 

ns 

Rise  and  Fall  Time  for  Clock  Input 

if  M 

- 

20 

- 

20 

_ 

20 

ns 

ivium  tui  y  muoib&s  utttcjy   lime 

lMAD 

- 

I0U 

_ 

IW 

_ 

ibU 

ns 

Raster  Address  Delay  Time 

'RAD 

_ 

160 

_ 

160 

_ 

160 

ns 

Display  Timing  Deiay  Time 

'DTD 

- 

'250 

_ 

250 

- 

200 

ns 

Horizontal  Sync  Delay  Time 

'HSD 

- 

250 

_ 

250 

..... 

200 

ns 

Vertical  Sync  Delay  Time 

>VSP 

_ 

250 

_ 

250 

_ 

200 

ns 

Cursor  Display  Timing  Delay  Time 

'CDD 

_ 

250 

_ 

250 

_ 

200 

ns 

F1GURE4- CRTC  TIMING  CHART 
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NOTE    Timing  measufemems  are  teierenced  to  and  from  a  low  voltage  of  0  8  volts  and  a  high  voltage  of  2  0  volts  unless  otherwise  noted 
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CRTC  INTERFACE  SYSTEM  DESCRIPTION 


The  MC6835  CRT  Controller  generates  the  signals 
necessary  to  interface  a  digital  system  to  a  raster  scan  CRT 
display  In  this  type  of  display,  an  electron  beam  starts  in  the 
upper  left  hand  corner,  moves  quickly  across  the  screen  and 
returns  This  action  is  called  a  horizontal  scan  After  each 
horizontal  scan  the  beam  is  incrementally  moved  down  in  the 
vertical  direction  until  it  has  reached  the  bottom  At  this 
point  one  frame  has  been  displayed,  as  the  beam  has  made 
many  horizontal  scans  and  one  vertical  scan 

Two  types  of  raster  scanning  are  used  in  CRTs,  interlace 
and  non-interlace.  shown  in  Figures  5  and  6  Non-interiacing 
scanning  consists  of  one  field  per  frame  The  scan  lines  in 
Figure  5  are  shown  as  solid  lines  and  the  retrace  patterns  are 
indicated  by  the  dotted  Sines  Increasing  the  number  of 
frames  per  second  will  decrease  the  flicker  Ordinarily,  either 
a  50  or  60  frame  per  second  refresh  rate  is  used  to  minimize 
beating  between  the  frequency  of  the  CRT  horizontal 
oscillator  and  the  power  line  frequency  This  prevents  the 
displayed  data  from  weaving  or  swimming 

Interlace  scanning  is  used  in  broadcast  TV  and  on  data 
monitors  where  high  density  or  high  resolution  data  must  be 
displayed  Two  fields,  or  vertical  scans  are  made  down  the 
screen  for  each  single  picture  or  frame   The  first  field  (Even 


field)  starts  in  the  upper  left  hand  corner;  the  second  (Odd 
field)  in  the  upper  center  Both  fields  overlap  as  shown  in 
Figure  6.  thus  interlacing  the  two  fields  into  a  single  frame 

In  order  to  display  the  characters  on  the  CRT  screen  the 
frames  must  be  continually  repeated  The  data  to  be 
displayed  is  stored  in  the  Refresh  (Screen)  memory  by  the 
MPU  controlling  the  data  processing  system  The  data  is 
usually  written  in  ASCII  code,  so  it  cannot  be  directly 
displayed  as  characters  A  Character  Generator  ROM  is 
typically  used  to  convert  the  ASCII  codes  into  the  "dot"  pat- 
tern for  every  character 

The  most  common  method  of  generating  characters  is  to 
create  a  matrix  of  f'x"  dots  (columns)  wide  and  '"y"  dots 
(rows)  high  Each  character  is  created  by  selectively  filling  in 
the  dots  As  "x"  and  '"y"  get  larger  a  more  detailed  character 
may  be  created  Two  common  dot  matrices  are  5x7  and 
7x9  Many  variations  of  these  standards  will  allow  Chinese. 
Japanese,  or  Arabic  letters  instead  of  English  Since 
characters  require  some  space  between  them,  a  character 
block  larger  than  the  character  is  typically  used  as  shown  in 
Figure  7  The  figure  also  shows  the  corresponding  timing 
and  levels  for  a  video  signal  that  would  generate  the 
characters 


FIGURE  5  -  RASTER  SCAN  SYSTEM  (NON-INTERLACE) 
-  Active  Display 


Vertical  Seen  Period 


Vertical  Retrace  Period 


FIGURE  6  -  RASTER  SCAN  SYSTEM  (INTERLACE) 


-Even  Number  Field  (First) 


— , — , Odd  Number  Fieid  f  Second) 
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FIGURE  7  -  CHARACTER  DISPLAY  ON  THE  SCREEN  AND  VIDEO  SIGNAt 
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Processor  gets  priority  access  anytime,   but  can  be 
synchronized  by  an  interrupt  to  perform  accesses  only 
during  horizontal  and  vertical  retrace  times 
Synchronize  the  processor  with  memory  wait  cycles 
(states) 

Synchronize  the  processor  to  the  character  rate  as 
shown  in  Figure  8  The  M6800  processor  family  works 
very   well    in    this   configuration   as   constant   cycle 
lengths    are    present     This    method     provides    no 
overhead  for  the  processor  as  there  is  never  a  conten- 
tion    for    a     memory    access      All     accesses    are 
transparent 

FIGURE  8  -  TRANSPARENT  REFRESH  MEMORY 
CONFIGURATION  TIMING  USING  M6800  FAMILY  MPU 

Figure  1                                                                                                                        ™ 
The  processor  communicates  with  the  CRTC  through  an 

CRTC  Accesses 
Refresh  Memory 

1 

8-bit  data  bus  by  writing  into  the  five  user  programmable 
registers  of  the  MC6835 

The  Refresh  memory  address  is  multiplexed  between  the 
processor  and  the  CRTC    Data  appears  on  a  secondary  bus                            £ 
separate  from  the  processors  bus  The  secondary  data  bus 
concept  in  no  way  precludes  using  the  Refresh  RAM  for 
other  purposes  )t  looks  like  any  other  RAM  to  the  processor 

MPU  Accesses     1 
Refresh  Memos v    1 

1 
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for  the  Refresh  memory 

1     Processor  always  gets  pr 
curs  as  MPU  and  CRTC  < 
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PIN  DESCRIPTION 


PROCESSOR  INTERFACE 

The  CRTC  interfaces  to  a  pro£essor  bus  on  the  data  bus 
(D0-D7)  using  CS.  RS.  E.  and  W  for  control  signals 

Data  Bus  (D0-D7}  -  The  data  lines  (D0-D7J  comprise  the 
write  only  data  bus 

Enable  (El  -  The  Enable  signal  is  a  high-impedance 
TTL/MOS-cornpatibie  input  which  enables  the  data  bus  in- 
put/output buffers  and  clocks  data  to  the  CRTC  This  signal 
is  usually  derived  from  the  processor  clock  The  high-to-low 
transition  is  the  active  edge 

Chip  Select  (CS)  -  The  CS  line  is  an  active-low  high- 
impedance  TTL/MOS-compatible  input  which  selects  the 
CRTC  write  to  the  internal  register  file  This  signal  should 
only  be  active  when  there  is  a  valid  stable  address  being 
decoded  from  the  processor 

Register  Select  (RS)  -  The  RS  line  is  a  high-impedance 
TTL/MOS-compatible  input  which  selects  either  the  Ad- 
dress Register  (RS  =  "0"1  or  one  of  the  Data  Registers 
(RS  =  "1")  of  the  internal  register  file  when  CS  is  low 

Write  (W)  -  The  W  line  is  a  high-impedance  TTL/MOS- 
compatible  input  which  determines  whether  the  internal 
register  file  gets  written    A  write  is  defined  as  a  low  level 

CRT  CONTROL 

The  CRTC  provides  horizontal  sync  (HS).  vertical  sync 
(VS).  and  display  enable  (DE)  signals 

NOTE  -  Care  should  be  exercised  when  interfacing  to 
CRT  monitors  as  many  monitors  claiming  to  be  "TTL  com- 
patible, have  transistor  input  circuits  which  require  the 
CRTC  or  TTL  devices  buffering  signals  from  the  CRTC/video 
circuits  to  exceed  the  maximum  rated  drive  currents 

Vertical  Sync  (VS)  and  Horizontal  Sync  (HS)  -  These 
TTL-compatible  outputs  are  active-high  signals  which  drive 
the  monitor  directly  or  are  fed  to  the  video  processing  cir- 
cuitry to  generate  a  composite  video  signal  The  VS  signal 
determines  the  vertical  position  of  the  displayed  text  whiie 
the  HS  signal  determines  the  horizontal  position  of  the 
displayed  text 


the  Memory  Addresses  and  the  Row  Addresses  continue  to 
run  during  vertical  retrace  thus  allowing  the  CRTC  to  provide 
the  refresh  addresses  required  to  refresh  dynamic  RAMs 

Refresh  Memory  Addresses  (MA0-MA13)  -  These  14  out- 
puts are  used  to  refresh  the  CRT  screen  with  pages  of  data 
located  within  a  16K  block  of  refresh  memory  These  outputs 
are  capable  of  driving  one  standard  TTL  load  and  30  pF 

Row  Addresses  (RA0-RA4)  -  These  five  outputs  from  the 
internal  Row  Address  counter  are  used  to  address  the 
Character  Generator  ROM  These  outputs  are  capable  of 
driving  one  standard  TTL  load  and  30  pF 

OTHER  PINS 

Cursor  -  This  TTL-compatible  output  indicates  a  valid 
Cursor  address  to  external  video  processing  logic  It  is  an 
active-high  signal 

Clock  (CLK)  -  The  CLK  is  a  TTL/MOS-compatible  input 
used  to  synchronize  all  CRT  functions  except  for  the  pro- 
cessor interface  An  external  dot  counter  is  used  to  derive 
this  signal  which  is  usually  the  character  rate  in  an 
alphanumeric  CRT    The  active  transition  is  high-to-low 

Program  Select  (PROG)  -  This  TTL-compatible  input 
allows  selection  of  one  of  two  sets  of  mask  programmed 
video  formats  Set  zero  is  selected  when  PROG  is  low  and 
set  one  is  selected  when  PROG  is  high 

Vcc<  GND  -  These  inputs  supply  +-5  Vdc  ±5%  to  the 
CRTC 

RESET  -  The  RESET  input  is  used  to  reset  the  CRTC 
Functionality  of  RESET  differs  from  that  of  other  M6800 
parts  RESET  must  remain  iow  (or  at  least  one  cycle  of  the 
character  clock  (CLK)  A  low  level  on  the  RESET  input 
forces  the  CRTC  into  the  following  state: 

a     All  counters  in  the  CRTC  are  cleared  and  the  device 

stops  the  display  operation 
b     All  the  outputs  are  driven  low.  except  the  MA0-MA13 
outputs  which  are  driven  to  the  current  value  in  the 
Start  Address  Register 
c    The  control  registers  of  the  CRTC  are  not  affected  and 

remain  unchanged 
d     The  CRTC  resumes  the  display  operation  immediately 
after  the  release  of  RESET 


Display  Enable  (DE)  -  This  TTL-compatible  output  is  an 
active-high  signal  which  indicates  the  CRTC  is  providing  ad- 
dressing in  the  active  Display  Area 

REFRESH    MEMORY/CHARACTER    GENERATOR    AD- 
DRESSING 

The  CRTC  provides  Memory  Addresses  (MA0-MA13)  to 
scan  the  Refresh  RAM  Row  Addresses  (RA0-RA4)  are  also 
provided  for  use  with  character  generator  ROMs  In  a 
graphics  system  both  the  Memory  Addresses  and  the  Row 
Addresses  would  be  used  to  scan  the  Refresh  RAM    Both 


CRTC  DESCRIPTION 

The  CRTC  consists  of  mask-programmable  horizontal  and 
vertical  timing  generators,  software-programmable  linear  ad- 
dress register,  mask-programmable  cursor  logic  and  control 
circuitry  for  interfacing  to  a  M6800  family  microprocessor 
bus 

All  CRTC  timing  is  derived  from  CLK  f  usually  the  output  of 
an  external  dot  rate  counter  Coincidence  (CO)  circuits  con- 
tinuously compare  counter  contents  to  the  contents  of  the 


© 


MOTOROJL/I  Semiconductor  Products  Inc. 


TABLE  1  -  INTERNAL  REGISTER  ASSIGNMENT 


cs 

RS 

Address  Register 

Register 

Register  File 

Program 
Unit 

Read 

Write 

Number  of  Bits          ] 

4 

3 

2 

1 

0 

7 

6 

5 

4 

3 

2 

1 

0 

1 

X 

X 

X 

X 

X 

X 

X 

- 
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_ 

_ 

\ 

\ 

\ 

\ 

\ 

\ 

\ 

\ 

0 

0 

X 

X 

X 

X 

X 

AR 

Address  Register 

_ 

No 

Yes 

\s 

\ 

\   Note  3    / 

RO 

Horizontal  Total 

Char. 

No 

No 

R1 

Horizontal  Displayed 

Char. 

No 

No 

R2 

H.  Sync  Position 

Char 

No 

No 

R3 

Sync  Width 
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No 

No 

V 

V 

V 

V 

H 

H 

H 

H 

R4 

Vertical  Total 

Char.  Row 

No 

No 

\ 

R5 

V.  Total  Adjust 

Scan  Line 

No 

No 

s^ 

R6 

Vertical  Displayed 

Char.  Row 

No 

No 

X 

R7 

V    Sync  Position 

Char.  Row 

No 

No 

\ 

R8 

Interlace  Mode  and  Skew 

Note  1 

No 

No 

C 

c 

D 

D 

I 

I 

R9 

Max  Scan  Line  Address 

Scan  Line 

No 

No 

\^ 

BIO 

Cursor  Start 

Scan  Line 

No 

No 

K 

R 

P 

INote2> 

Rll 

Cursor  End 

Scan  Line 

No 

No 

KXX 

0 

1 

0 

1 

1 

0 

0 

R12 

Stan  Address  (H) 

_ 

No 

Yes 

0 

0 

0 

\ 

0 

1 

1 

0 

1 

R13 

Stan  Address  (LI 
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No 

Yes 

0 

1 

0 

1 

1 

1 

0 

R14 

Cursor  IH) 

_ 

No 

Yes 
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0 

0 

1 

0 

1 

1 

1 

1 

R15 

Cursor  (LI 

„ 

No 

Yes 

NOTES 

1  The  Interlace  Control  is  shown  in  Table  2  while  Skew  Control  is  shown  in  Table  3 

2  Bit  5  of  the  Cursor  Stan  Raster  Register  ts  used  to  blink  period  control,  and  Bit  6  is  used  to  select  blink  or  non-blink 

3  R0-R1 1  are  mask-programmable  and  are  not  accessible  vi3  the  data  bus 


mask  programmable  register  file.  RG-R11    For  horizontal  tim- 
ing generation,  comparisons  result  in: 

1  Horizontal  sync  pulse  (HS)  of  a  frequency,  posttton 
and  width  determined  by  the  register  contents 

2  Horizontal  Display  signal  of  a  frequency  position  and 
duration  determined  by  the  register  contents 

The  horizontal  counter  produces  H  clock  which  drives  the 
Scan  Line  Counter  and  Vertical  Control  The  contents  of  the 
Raster  Counter  are  continuously  compared  to  the  Max  Scan 
Line  Address  Register  A  coincidence  resets  the  Raster 
Counter  and  clocks  the  Vertical  Counter 

Comparisons  of  Vertical  Counter  contents  and  Vertical 
Registers  result  in; 

1  Vertical  sync  pulse  (VS)  of  a  frequency,  position  and 
width  determined  by  the  register  contents 

2  Vertical  Display  signal  of  a  frequency,  position,  and 
duration  determined  by  the  register  contents 

The  Vertical  Control  Logic  has  other  functions: 

1  Generate  row  selects,  RA0-RA4,  from  the  Raster 
Count  for  the  corresponding  interlace  or  non-imerlace 
modes 

2  Extend  the  number  of  scan  lines  in  the  vertical  total  by 
the  amount  programmed  in  the  Vertical  Total  Adjust 
Register 

The  cursor  logic  determines  the  size  and  blink  rate  of  the 


cursor  as  indicated  by  the  register  contents 

The  Linear  Address  Generator  is  driven  by  CLK  and 
locates  the  relative  positions  of  characters  in  memory  and 
their  positions  on  the  screen  Fourteen  outputs.  MA0-MA13, 
are  available  for  addressing  up  to  four  pages  of  4K 
characters,  eight  pages  of  2K  characters,  etc 

Five  additional  write-only  registers  define  the  Start  Ad- 
dress and  cursor  position  Using  the  Start  Address  Register, 
hardware  scrolling  through  16K  characters  is  possible  The 
Linear  Address  Generator  repeats  the  same  sequence  of  ad- 
dresses for  each  scan  tine  of  a  character  row  The  Start  Ad- 
dress Register  and  the  Cursor  Position  Register  are  program- 
med by  the  processor  through  the  data  bus,  D0-D7  and  the 
control  signals  -  W.  CS.  RS.  and  JE    Refer  to  Figure  9 


REGISTER  FILE  DESCRIPTION 

The  MC6B35  has  17  control  registers  of  which  12  are  mask 
programmable  The  remaining  five  registers  —  Address 
register,  Start  Address  register  pair,  and  Cursor  Position 
register  pair  -  are  write-only  registers  programmed  by  the 
MPU  These  registers  control  horizontal  timing,  vertical  tim- 
ing, interlace  operation,  row  address  operation  and  define 
the  cursor,  cursor  address,  and  start  address  The  register 
addresses  and  sizes  are  shown  in  Table  1 
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FIGURE9  -  CRTC  BLOCK  DIAGRAM 


Vcc    GND 


Prog     W   CSRS     E       RESET 

f     I  M  ♦ i— 


Horizontal 

CTR  <  -5-  256) 

MC 


Horizontal 
Sync  Width 
CTR(  ■*-  16) 
MC 


Addfess  Register 
and  Decoder 


Character 
Row 
CTR  ( •+■  128) 
MC 

zzj — : 


c= 


Vertical 
Control 


Scan  Line 
r     CTR  (  -5-  32) 
MC 


r^>0C 


Vertical  Total  Reg 


Vertical  Totai 
Adjust  F 


V  Display 


Vertical  Displayed 


Vertical  Sync 
Position  Reg, 


C 


SI 


Hend- 
CLK- 


SnterSace  Mode  Reg 


li 


K: 


Max  Scan  Line 
Address  Reg. 


j    I        1        I jR10|     Cursor  Start  Reg       j 


Cursor 
Contol 


Linear 
Address 
Generator 


c 


Cursor  End  Reg 


j^{^|  Start  Address  Reg 


© 


\^7  MAOMA13 


-NJrmI 
Vfel 


Cursor  Address  Reg 


\V/7RA0-RA4  \^MA0-MA13  |      D0-D7 

$¥8€>Jm€>IR®LA  Semiconductor  Products  Inc. 


tyMtitfi} 


MASK  PROGRAMMABLE  REGISTERS  RO-R11 

The  twelve  mask  programmable  registers  determine  the 
display  format  generated  by  the  MC6835  The  PROG  input  is 
used  to  select  one  of  two  sets  of  register  values 

Figure  10  shows  the  visible  display  area  of  a  typical  CRT 
monitor  giving  the  point  of  reference  for  horizontal  registers 
as  the  left  most  displayed  character  position  Horizontal 
registers  are  programmed  in  character  clock  time  units  with 
respect  to  the  reference  as  shown  in  Figure  1 1  The  point  of 
reference  for  the  vertical  registers  is  the  top  character  posi- 
tion displayed  Vertical  registers  are  programmed  in 
character  row  times  or  scan  line  times  as  shown  in  Figure  12 

Horizontal  Total  Register  (R0|  ~  This  8-bit  register  deter- 
mines the  horizontal  sync  (HS)  frequency  by  defining  the  HS 
period  in  character  times  It  is  the  total  of  the  displayed 
characters  plus  the  non-displayed  character  times  (retrace) 
minus  one 

Horizontal  Displayed  Register  (R1)  -  This  8-bit  register 
determines  the  number  of  displayed  characters  per  line  Any 
8-bit  number  may  be  programmed  as  long  as  the  contents  of 
RO  are  greater  than  the  contents  of  R1 

Horizontal  Sync  Position  Register  (R2)  -  This  8-bit 
register  controls  the  HS  position  The  horizontal  sync  posi- 
tion defines  the  horizontal  sync  delay  (Front  Porch)  and  the 
horizontal  scan  delay  (Back  Porch)  When  the  programmed 
value  of  this  register  is  increased,  the  display  on  the  CRT 
screen  is  shifted  to  the  left  When  the  programmed  value  is 


decreased  the  display  is  shifted  to  the  right  Any  8-bit 
number  may  be  programmed  as  long  as  the  sum  of  the  con- 
tents of  R1.  R2.  and  the  lower  four  bits  of  R3  are  less  than 
the  contents  of  RO 

Sync  Width  Register  (R31  -  This  8-bit  register  determines 
the  width  of  the  vertical  sync  (VS)  pulse  and  the  horizontal 
sync  (HSt  pulse  Programming  the  upper  four  bits  for  1-to-15 
will  select  VS  pulse  widths  from  l-to-15  scan-line  times  Pro- 
gramming the  upper  four  bits  as  zeros  will  select  a  VS  pulse 
width  of  16  scan  line  times  The  HS  pulse  width  may  be  pro- 
grammed from  1-to-15  character  clock  periods  thus  allowing 
compatibility  with  the  HS  pulse  width  specifications  of  many 
different  monitors  If  zeros  are  written  into  the  lower  four 
bits  of  this  register,  then  no  HS  is  provided 

Horizontal  Timing  Summary  (Figure  11)  -  The  difference 
between  RO  and  R1  is  the  horizontal  blanking  interval  This 
interval  in  the  horizontal  scan  period  allows  the  beam  to 
return  (retrace)  to  the  left  side  of  the  screen  The  retrace  time 
is  determined  by  the  monitor's  horizontal  scan  components 
Retrace  time  is  less  than  the  horizontal  blanking  interval  A 
good  rule  of  thumb  is  to  make  the  horizontal  blanking  about 
20%  of  the  total  horizontal  scanning  period  for  a  CRT  In  in- 
expensive TV  receivers,  the  beam  overscans  the  display 
screen  so  that  aging  of  parts  does  not  result  in  underscan- 
ning  Because  of  this,  the  retrace  time  should  be  about  1/3 
the  horizontal  scanning  period  The  horizontal  sync  delay. 
HS  pulse  width  and  horizontal  scan  delay  are  typically  pro- 
grammed with  1:2:2  ratio 
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FIGURE  10  -  ILLUSTRATION  OF  THE  CRT  SCREEN  FORMAT 
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NOTE  1:   Timing  values  are  described  in  Table  8 
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TABLE  2  ~~  INTERLACE  MODE  REGISTER 


TABLE  3  -  CURSOR  START  REGISTER 


Bit  1 

BitO 

Mode 
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0 
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0 
0 
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Non- Blink 
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RGURE  13  -  INTERLACE  CONTROL 
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b)  Interlace  Sync 

c)  Interlace  Sync  and  Video 

Vertical  Total  Register  (R4)  and  Vertical  Total  Adjust 
Register  {R5}  -  The  frequency  of  VS  is  determined  by  both 
R4  and  R5  The  calculated  number  of  character  line  times  is 
usually  an  integer  plus  a  fraction  to  get  exactly  a  50  or  60  Hz 
vertical  refresh  rate  The  integer  number  of  character  line 
times  minus  one  is  programmed  in  the  7-bit  Vertical  Total 
Register  (R4)  The  fraction  of  character  line  times  is  pro- 
grammed in  the  5-bit  Vertical  Total  Adjust  Register  (R5)  as  a 
number  of  scan  line  times 

Vertical  Displayed  Register  (R6)  -  This  7-bit  register 
specifies  the  number  of  displayed  character  rows  on  the  CRT 
screen,  and  is  programmed  in  character  row  times  Any 
number  smaller  than  the  contents  of  R4  may  be  programmed 
into  R6 

Vertical  Sync  Position  (R7)  -  This  7-bit  register  controls 
the  position  of  vertical  sync  with  respect  to  the  reference  it 
is  programmed  in  character  row  times  The  value  programm- 
ed in  the  register  is  one  less  than  the  number  of  computed 
character  line  times  When  the  programmed  value  of  this 
register  is  increased,  the  display  position  of  the  CRT  screen 
is  shifted  up  When  the  programmed  value  is  decreased  the 
display  position  is  shifted  down  Any  number  equal  to  or  less 
than  the  vertical  total  (R4)  may  be  used 

Interlace  Mode  and  Skew  Register  (R8)  -  This  6-bit 
register  controls  the  interlace  modes  and  allows  a  program- 
mable delay  of  zero  to  two  character  clock  times  for  the  DE 
(display  enable)  and  Cursor  outputs  Table  2  shows  the  in- 
terlace modes  available  to  the  user  These  modes  are 
selected  using  the  two  low  order  bits  of  this  6-bit  register 


Table  4  describes  operation  of  the  Cursor  and  DE  skew 
bits  Cursor  skew  is  controlled  by  bits  6  and  7  of  R8  while  DE 
skew  is  controlled  by  bits  4  and  5 

In  the  normal  sync  mode  tnon-interlace)  only  one  field  is 
available  as  shown  in  Figure  5  and  13a  Each  scan  line  is 
refreshed  at  the  VS  frequency  (e  g  .  50  or  60  Hz) 

Two  interlace  modes  are  available  as  shown  in  Figures  6. 
13b.  and  13c  The  frame  time  is  divided  between  even  and 
odd  alternating  fields  The  horizontal  and  vertical  timing  rela- 
tionship (VS  delayed  by  1/2  scan  line  time)  results  in  the 
displacement  of  scan  lines  in  the  odd  field  with  respect  to  the 
even  field 

In  the  Interlace  Sync  mode  the  same  information  is  painted 
in  both  fields  as  shown  in  Figure  13b  This  is  a  useful  mode 
lor  filling  in  a  character  to  enhance  readability 

in  the  Interlace  Sync  and  Video  mode  alternating  lines  of 
the  character  are  displayed  in  the  even  field  and  the  odd 
field  This  effectively  doubles  the  number  of  characters  thai 
may  be  displayed  on  a  CRT  monitor  of  a  given  bandwidth 

Care  must  be  taken  when  using  either  interlace  mode  to 
avoid  an  apparent  flicker  effect  This  flicker  effect  is  due  to 
the  doubling  of  the  refresh  period  for  all  scan  lines  since  each 
field  is  displayed  alternately  Flicker  may  be  minimized  with 
proper  monitor  design  (e  g  ,  longer  persistence  phosphors) 

In  addition,  there  are  restrictions  on  the  programming  of 
the  CRTC  registers  for  interlace  operation: 

a  The  Horizontal  Total  Register  value.  R0.  must  be  odd 
(i  e  .  an  even  number  of  character  times) 

b  For  the  Interlace  Sync  and  Video  mode  only,  the  Ver- 
tical Displayed  Register  (R6)  must  be  even  The  pro- 
grammed number.  Nvd.  must  be  Vi  the  actual  number 
required 
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TABLE  4  -  CURSOR  AND  DE  SKEW  CONTROL 


Value 

Skew 

00 
01 
10 
11 

No  Character  Skew 
One  Character  Skew 
Two  Character  Skew 
Not  Available 

Maximum  Scan  Line  Address  Register  (R9)  -  This  5-btt 
register  determines  the  number  of  scan  lines  per  character 
row  including  the  spacing  thus  controlling  operation  of  the 
Row  Address  counter  The  programmed  value  is  a  maximum 
address  and  ts  one  less  than  the  number  of  scan  lines 

Cursor  Start  Register  (R10)  and  Cursor  End  Register  (RID 
These  registers  allow  a  cursor  of  up  to  32  scan  lines  in 
heiaht  to  be  placed  on  any  scan  line  of  the  character  block  as 
,  ~  .  _.  r_..  .  ;.■;  H;0;<  ;"'  h:t  :;::'::: to'  ■.■l:t'H  '^  r!f:'fln('  'h'' 
start  scan  line  and  blink  rate  for  the  cursor  Bus  5  and  6  of 
the  Cursor  Start  Address  Register  control  the  cursor  opera- 
tion as  shown  in  Table  4  Non-display,  display  and  two  blink 
modes  (16  times  or  32  times  the  field  period)  are  available 
R11  is  a  5-bit  register  which  defines  the  last  scan  tine  of  the 
cursor 

When  an  external  blink  feature  on  characters  is  required,  it 
may  be  necessary  to  perform  cursor  blink  externally  so  that 
both  blink  rates  are  synchronized  Note  that  an  mven/non- 
i riven  cursor  is  easily  implemented  by  programming  the 
CRTC  for  a  blinking  cursor  and  externally  inverting  the  video 
signal  with  an  exclusive-OR  gate 

PROGRAMMABLE  REGISTERS 
The  four  programmable  registers  allow  the  MRU  to  posi- 


tion the  cursor  anywhere  on  the  screen  and  allow  the  start 
address  to  be  modified 

The  Addfess  Register  is  a  five-bit  write-only  register  used 
as  an  '-indirect"  or  "pointer"  register  Its  contents  are  the  ad- 
dress of  one  of  the  other  18  registers  When  both  RS_and  CS 
are  low  the  Address  Register  is  selected  When  CS  is  low 
and  RS  is  high,  the  register  pointed  to  by  the  Address 
Register  is  selected 

Start  Address  Register  (R12-H,  R13-L)  -  This  14-bit 
write-only  register  pair  controls  the  first  address  output  by 
the  CRTC  after  vertical  blanking  It  consists  of  an  8-bit  low 
order  (MA0-MA7)  register  and  a  6-bit  high  order  (MAS- 
MAIS)  register  The  start  address  register  determines  which 
portion  of  the  refresh  RAM  is  displayed  on  the  CRT  screen 
Hardware  scrolling  by  character,  line  or  page  may  be  ac- 
complished by  modifying  the  contents  of  this  register 

Cursor  Register  (R14-H,  R15-L}  -  This  14-bit  write-only 
register  pair  is  programmed  to  position  the  cursor  anywhere 
in  the  refresh  RAM  area  thus  allowing  hardware  paging  and 
scrolling  through  memory  without  loss  of  the  original  cursor 
position  It  consists  of  an  8-bit  low  order  (MA0-MA7)  register 
and  a  6-bit  high  order  (MA8-MA13)  register 

CRTC  INITIALIZATION 

Registers  R12-R15  must  be  initialized  after  the  system  is 
powered  up  The  processor  will  normally  load  the  CRTC 
register  file  from  a  firmware  table  Figure  15  shows  an  M6800 
program  which  could  be  used  to  program  the  CRT  Con- 
troller 


FIGURE  14  -  CURSOR  CONTROL 
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ADDITIONAL  CRTC  APPLICATIONS 

The  foremost  system  function  which  may  be  performed  by 
the  CRTC  controller  is  the  refreshing  of  dynamic  RAM  This 
is  quite  simple  as  the  refresh  addresses  continually  run 

Both  the  VS  and  the  HS  outputs  may  be  used  as  a  real 
time  clock  Once  programmed,  the  CRTC  will  provide  a 
stable  reference  frequency 

SELECTING  MASK  PROGRAMMED  REGISTER  VALUES 

A  prototype  system  may  be  developed  using  the  MC6845 
CRTC    This  will  allow  register  values  to  be  modified  as  re- 


quired to  meet  system  specifications  The  worksheet  of 
Table  5  is  extremely  useful  in  computing  proper  register 
values  for  the  MC6835  The  program  shown  in  Figure  15  may 
be  expanded  to  properly  load  the  calculated  register  values  in 
the  MC6845  Once  the  two  sets  of  register  values  have  been 
developed,  fill  ou!  the  ROM  program  worksheet  of  Figure  18 
To  order  a  custom  programmed  MC6835.  contact  your 
local  field  service  office,  local  sales  person  or  your  local 
Motorola  representative  A  manufacturing  mask  will  be 
developed  for  the  data  entered  in  Figure  18 


FIGURE  15  -  M6800  PROGRAM  FOR  CRTC  INITIALIZATION 


PAGE   001 

00001 

00002 

00003 

00004 

00005 

00006 

00007 

00008 

00009 

00010 

000X1 

00012A 

00013A 


CRTCINIT.SA:!   MC6835  CRTC  initialization  program 


300 


C6 


1020 
1020 
1022 


MC6835 

CRTC  initialization  program 

G,S,LLE=85  print  FCB'x,  FDB's  &  XREF  table 
************************************** 

*  Assign  CRTC  address 


NAM 
TTL 

OPT 
************** 


9000 
9001 


10 
F2 


00014A  0002  CE 

00015A  0005  F7 

00016A  0008  A6  00 

00017A  000A  B7  90 

00018A  000D  08 

00019A  000E  5C 

00020A  000F  Dl 

00021A  0011  26 

00022A  0013 

00023 

00024 

00025 

00026A 

00027A 

00028A 

00029 

TOTAL  ERRORS  000 


0C 

1020 

9000 


3F 


A 
0005 


CRTCAD  EQU 
CRTCRG  EQU 
************* 


******* 

Initialization  Program 


$9000    Address  Register 
CRTCAD+1  Data  Register 


************************ 


CRTC1 


ORG 

LDAB 

LDX 

STAB 

LDAA 

STAA 

INX 

INCB 

CMPB 

BNE 

SWI 
************************************************* 
*  CRTC  register  initialization  table 


0 

$C 

38RTTAB 

CRTCAD 

0,X 

CRTCRG 


$10 
CRTC1 


a  place  to  start 

initialize  pointer 

table  pointer 

load  address  register 

get  register  value  from  table 

program  register 

increment  counter 

finished? 

no:  take  branch 

yes:  call  monitor 


ORG 
CRTTAB  FDB 

FDB 
END 


$1020     start  o£  table 

$0080     R12,  R13  -  Start  Address 

$0080     R14,  R15  -  Cursor  Address 


CRTC1   0005   CRTCAD  9000   CRTCRG  9001   CRTTAB  1020 
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OPERATION  OF  THE  CRTC 


Timing  of  the  CRT  Interface  Signals  -  Timing  charts  of 
CRT  interface  signals  are  illustrated  in  this  section  with  the 
aid  of  programmed  example  of  the  CRTC  When  values 
listed  in  Table  7  are  programmed  into  CRTC  control 
registers,  the  device  provides  the  outputs  as  shown  in  the 
Timing  Diagrams  (Figures  11.   12.   16.  and  17)    The  screen 


format  of  this  example  is  shown  in  Figure  10.  Figure  17  is  an 
illustration  of  the  relation  between  Refresh  Memory  Address 
(MA0-MA13).  Raster  Address  (RA0-RA4)  and  the  position 
on  the  screen  in  this  example,  the  start  address  is  assumed 
to  be  J'0'' 


TABLE  7  -  VALUES  PROGRAMMED  INTO  CRTC  REGISTERS 


Register 
Number 

Register  Name 

Value 

Programmed 
Value 

RO 

H.  Total 

Nhi+1 

Nht 

R1 

H.  Displayed 

Nhd 

Nhd 

R2 

H.  Sync  Position 

Nhsp 

Nhsp 

M 

h    Svnr  Width 

Nhw. 

Nhsw 

R4 

V.  Total 

Nvt+t 

Nvt 

R5 

V.  Scan  Line  Adjust 

Nadj 

Nadi 

R6 

V,  Displayed 

Nvd 

Nvd 

R7 

V.  Sync  Position 

Nvsp 

Nvsp 

R8 

Interface  Mode 

R9 

Max.  Scan  Line  Address 

NS1 

Ns! 

RIO 

Cursor  Start 

R11 

Cursor  End 

R12 

Start  Address  (HI 

0 

R13 

Start  Address  ID 

0 

R14 

CufSOr  (HJ 

R15     j Cursor  ID 
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FIGURE  18  -  ROM  PROGRAM  WORKSHEET 


The  value  in  each  register  of  the  MC6845  should  be  entered  without  any  modifications   Motorola  will  take  care  of  translating  into  the  appropriate 
format 

D  All  numbers  are  in  decimal       D  Al!  numbers  are  in  hex 


ROM 

Program 

Zero 

(PROG  =  0> 


ROM 

Program 

One 

(PROG-1) 


RO 
R1 
R2 
R3 
R4 
R5 
R6 


R9 
RIO 
Rll 


ORDERING  INFORMATION 


Package  Type 

Frequency  (MHz) 

Temperature 

Order  Number 

Ceramic 
L  Suffix 

1  0 
1  0 
1  5 
1  5 
20 
2.0 

0DC  to  70°C 
~50oCio85oC 

0°C  to  70°C 
-50°C  to85°C 

0°C  to  70°C 
~50°C  to85°C 

MC6835L 

MC5835CL 

MC68A35L 

MC68A35CL 

MC68B35L 

MC68B35CL 

Cerdip 
S  Suffix 

1  0 
1  0 
1  5 
1  5 
20 
2.0 

0QC  to  70°C 
~50°C  to85°C 

0°C  to  70°C 
-50°C  to85°C 

0DC  to  70°C 
-50CC  to85°C 

MC6835S 

MC6835CS 

MC68A35S 

MC68A35CS 

MC68835S 

MC68835CS 

Plastic 
P  Suffix 

1  0 
1  0 
1  5 
1  5 
20 
2.0 

0DC  to  70°C 
~50°Cto85°C 

0°C  to  70°C 
-50°C  to85°C 

0°C  to  70°C 
~50°C  to85°C 

MC6835P 

MC6835CP 

MC68A35P 

MC68A35CP 

MC68S35P 

MC68835CP 
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PACKAGE  DIMENSIONS 


i  i  i  ii 

SEATING  PLANE  J  !    I 
c>    L 


ffVf 


-J-,       m-j  I- 


OSM 

MILLIMETERS 

iNCKES 

MIN 

MAX 

MIN 

MAX 

A 

SO. 29 

51.31 

1.980 

3.020 

H 

14.34 

15.34 

0.58S 

0.604 

C 

3.05 

0.S2G 

0.160 

0 

0.3B 

0.53 

0.021 

r 

0.76 

1.40 

0.03G 

0.055 

G 

1.54  8SC 

aioaasc 

H 

0.76 

O.G30 

0.070 

J 

0.20 

0.33 

a  bas 

0013 

K 

2,54 

4.19 

0.100 

0.565 

L 

14  93 

15.49 

0.590 

0610 

IN 

102 

1.52 

0  040  1  O.OEG 

I  SUFFIX 

CERAMIC  PACKAGE 
CASE71WM 


NOTES 

!    LEADS  TRUE  POSITIONED  WITHIN  0.25  mm 
(G.QSO)  OIA  (AT  SEATING  PUNEI  AT  MAX 
MAT'L  CONDITION. 
2.  OIMENSION  'V  TO  CENTER  OF  LEADS 
WHEN  FGflMEO  PAI1ALLEL 


P  SUFFIX 

PLASTIC  PACKAGE 
CASE  71 1-00 


P^ 


MILLIMETERS 

INCHES 

DIM 

MlfTI  MAX 

MIN   , 

MAX 

A 

5165 

57  45 

.'0J5 

2  065 

ft 

u  n 

14  23 

0  540 

JT5JJ0, 

r. 

3<M 

SOB 

0  155 

G200 

D 

lQ36 

0  56 

0  023 

F 

102 

1  53 

0  040 

0060 

n 

2 .W  BSC 

o  moose 

H 

5  65 

2S6 

0  065  1  0  085 

J 

0  30 

0  38 

0008]  0015 

K 

2  62 

3  43 

0115)  0135 

1 

15  34  DSC 

0  GOG BSC 

102  I  0  0301  OQ40 


NOTES 

!   POSITIONAL  TOLERANCE  OF  tEAOS  (01 
SHALL  BE  WITHIN  0  25  mm  10  0101  AT 
MAXIMUM  MATEPiSAt  CONDITION,  IN 
RELATION  TO  SEATING  PLANE  AND 
EACH  OTHER 

2  DIMENSION  L  10  CENTER  OF  LEAOS 
WHEN  FORMED  PARALLEL 

3  DIMENSION  8  DOES  NOT  INCLUDE 
MOID  FLASH 


S  SUFFIX 

CERDIP  PACKAGE 
CASE  734-03 


0tM 

MILUMETEnS 

INCHES_j 

53  21 
75*5" 

3  070 

1!  JO 

n 

5Bi 

0160 

0  730 

0  3S 

0  56 

0015 

165 

0  050 

0  065 

f 

1  54  BSC 
'0?D_1    010 

15  31BSC 
5°      [   15" 

0  100  BSC 

'oooa  1  ooij 

0  135  j  0.1_C0_ 
i"- 1    15" 

OGJO  !  0  050 

NOHS 

t      DIMEHSIONVltS  DATUM 
7     POSITIONAL  TOLERANCE 
FOH  LFAOS 

|  ■»  j  ♦QiSiooioK^ITTA^n 

3  CO  IS  SEATING  PLANE 

4  DIMENSION  L  TOCEUTEII 
OF  LEADS  WHEN  FOHMEO 
PARALLEL 

5  DIMENSION  A  AND  0 
INCLUDES  MENISCUS 


Motorola  reserves  the  right  to  make  changes  to  any  products  herein  to  improve  reliability,  function  or  design  Motorola  does  not  ossumeanviiahilityarismg 
out  of  the  application  or  use  of  any  product  or  circuit  described  herein;  neither  does  it  convey  any  license  under  us  patent  rights  nor  the  rights  of  others 
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WESTEffM  Oi 

CORPORATION 

BR1941(5016)  Dual  Baud  Rate  Clock 


16  SELECTABLE  BAUD  RATE  CLOCK  FREQUENCIES 

SELECTABLE  1X,  16X  OR  32X  CLOCK  OUTPUTS  FOR 

FULL  DUPLEX  OPERATIONS 

OPERATES  WITH  CRYSTAL  OSCILLATOR  OR 

EXTERNALLY  GENERATED  FREQUENCY  INPUT 

ROM  MASKABLE  FOR  NON-STANDARD  FREQUENCY 

SELECTIONS 

INTERFACES  EASILY  WITH  MICROCOMPUTERS 

OUTPUTS  A  50%  DUTY  CYCLE  CLOCK  WITH  0  01  % 

ACCURACY 

6  DIFFERENT  FREQUENCY/DIVISOR  PAIRS 

AVAILABLE 

TTLt  MOS  COMPATIBILITY 

PIN  COMPATIBLE  WITH  COM5016 


GENERAL  DESCRIPTION 

The  BR1941  is  a  combination  Baud  Rate  Clock  Gen- 
erator and  Programmable  Divider,  It  is  manufactured  in 
N-channe!  MOS  using  silicon  gate  technology  This  de- 
vice is  capable  of  generating  16  externally  selected 
clock  rates  whose  frequency  is  determined  by  either  a 
single  crystal  or  an  externally  generated  input  clock. 
The  BR1941  is  a  programmable  counter  capable  of 
generating  a  division  from  2  to  (215  -1) 

The  BR1941  is  available  programmed  with  the  most 
used  frequencies  in  data  communication  Each 
frequency  is  selectable  by  strobing  or  hard  wiring  each 
of  the  two  sets  of  four  Rate  Select  inputs  Other 
frequencies/division  rates  can  be  generated  by 
rep rog ramming  the  internal  ROM  coding  through  a 
MOS  mask  change  Additionally,  further  clock  division 
may  be  accomplished  through  cascading  of  devices 
The  frequency  output  is  fed  into  the  XTAL/EXT  input 
on  a  subsequent  device. 


00 


O 


XTAL/EXT  1 

c 

vcc 

c 

'R 

c 

Ra 

c 

Re 

c 

RC 

c 

RD 

c 

STR 

c 

VDD       C9 


1  D 


10  3 


3 

XTAUEXT  2 

3 

fT 

3 

TA 

3 

tb 

3 

TC 

3 

TD 

3 

STT 

3 

GND 

■INTERNALLY  BONDED  DO  NOT  CONNECT 
ANYTHING  TO  THIS  PIN 


TA ft> 

TB  ft- 

TC ft- 

TD  ft- 

D 

A 
T 
C 

FREQUENCY 
DECODE 

AND 
CONTROL 

FREQUENCY 
SELECT 
ROM 

^ 

_J 

< 

STT 

r               1 

XTAU ^ 

EXT1 

XTAU „, 

EXT  2 

OSCSLLATOR 

DIVIDER 

—  - 

+  1-!V 

DIVIDER 

*.rR 

GNO    — ft- 

STR  — 

_, 

i 

i 

L 

RA ft- 

RB ft" 

FIC  ft- 

RD  „_*. 

D 

A 

T 
C 

FREQUENCY 
DECODE 

AND 
CONTROL 

FREQUENCY 
SELECT 
RDM 

PIN  CONNECTIONS 


BR1941  BLOCK  DIAGRAM 
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PIN  DESCRIPTION 


00 
33 


CO 

4* 


O 


<?> 


PIN  NUMBER 

SYMBOL 

NAME 

FUNCTION 

1 

XTAUEXT  1 

Crystal  or 

Externa!  input  1 

This  input  receives  one  pin  of  the  crystal  package  or 
one  polarity  of  the  externa!  input. 

2 

vcc 

Power  Supply 

+  5  volt  Supply 

3 

fR 

Receiver  Output 
Frequency 

This   output    runs   at    a    frequency    selected    by   the 
Receiver  Address  inputs 

4-7 

Ra.  rb.  Rc.  rd 

Receiver  Address 

The  logic  level  on  these  inputs  as  shown  in  Tables  1 
through  6,  selects  the  receiver  output  frequency,  fp. 

B 

STR 

St  robe- Receiver 

Address 

A  high-level   input  strobe  loads  the  receiver  address 
{Ra,  Rb.  Rc.   RD)  *n*°  the  receiver  address  register 
This  input  may  be  strobed  or  hard  wired  to  +  5V 

9 

vdd 

Power  Supply 

+  12  volt  Supply 

10 

NC 

No  Connection 

Internally   bonded    Do   not  connect   anything   to  this 
pin 

Ground 

11 

GND 

Ground 

12 

STT 

Strobe-Transmitter 
Address 

A  high-level  input  strobe  loads  the  transmitter  address 
(Ta.  Tb>  T'C  "*'d)  'n,°  tne  transmitter  address  register., 
This  input  may  be  strobed  or  hard  wired  to  +  5V 

13-16 

TO.  TC  Tb,  Ta 

Transmitter 
Address 

The  logic  level  on  these  inputs,  as  shown  in  Tables  1 
through  6,  selects  the  transmitter  output  frequency,  fj 

17 

fj 

Transmitter 

Output 

Frequency 

This    output    runs    at    a    frequency    selected    by  the 
Transmitter  Address  inputs 

18 

XTAUEXT  2 

Crystal  or 
Externa! 
Input  2 

This    input    receives    the    other    pin    of    the    crystal 
package  or  the  other  polarity  of  the  external  input 

ADDRESS      X    2, 
VIL AJ 


\3  0' 
\1 


r-      tH( 


3C 


CONTROL  TIMING 


-> 


x>  *  -f>  c 


74XX  -  TOTEM  POLE  OR  OPEN  COLLECTOR  OUTPUT 


CRYSTAL/CLOCK  OPTIONS 


ABSOLUTE  MAXIMUM  RATINGS 

Positive  Voltage  on  any  Pin,  with  respect  to  ground 
Negative  Voltage  on  any  Pin,  with  respect  to  ground 
Storage  Temperature 


+  20.0V 

-  0.3V 

(plastic  package)  -55°Cto  +125°C 
(cerdtp  package  and  ceramic  package)  -  65°C  to  +  150°C 


Lead  Temperature  (Soldering,  10  sec ) 

'Stresses  above  those  listed  may  cause  permanent  damage  to  the  device  This  is  a  stress 
rating  only  and  Functional  Operation  of  the  device  at  these  or  at  any  other  condition 
above  those  indicated  in  the  operational  sections  of  this  specification  are  not  implied 


390 


ELECTRICAL  CHARACTER ISTtCS 

(Ta  =  0°C  to  +  70° C,  Vcc  =  +  5V  ±  5%,  Vdd  =  +  12V  ±  5%,  unless  otherwise  noted) 


PARAMETER 

MIN 

TYP 

MAX 

UNIT 

COMMENTS 

DC  CHARACTERISTICS 

!NPUT  VOLTAGE  LEVELS 
Low-level,  Vji_ 
High-level,  Vjh 

Vcc-  1-5 

08 

vcc 

V 
V 

See  Note  1 

OUTPUT  VOLTAGE  LEVELS 
Low- 1  eve  I,  Vol 
High-level,  Voh 

VCC- 15 

4.0 

0  4 

V 
V 

lOL  =  3.2  mA 
iOH  =  100mA 

INPUT CURRENT 
Low-level,  l|L 

03 

mA 

V|n  ~  GND,  excluding  XTAL  inputs 

INPUT  CAPACITANCE 
All  Inputs,  Cjn 

5 

10 

Pf 

V|fg  ™  GND,  excluding  XTAL  inputs 

INPUT  RESISTANCE 
Crystal  Input,  RxTAL 

11 

KQ 

Resistance  to  ground  for 

Pin  1  and  Pin  18 

POWER  SUPPLY  CURRENT 
'CC 

20 
20 

60 
70 

mA 
mA 

AC  CHARACTERISTICS 

TA  =  +25°C 

CLOCK  FREQUENCY 

See  Note  2 

PULSE  WIDTH  (Tpw) 
Clock 

Receiver  strobe 
Transmitter  strobe 

150 
150 

DC 
DC 

ns 
ns 

50%  duty  cycle  ±10%.  See  Note  2 

INPUT  SET-UP  TIME  OSET-UP) 
Address 

50 

ns 

See  Note  3 

OUTPUT  HOLD TIME{THOLD) 
Address 

50 

ns 

CD 
2? 


CD 


O 


NOTE  1:  BR1941  —  XTAL/EXT  inputs  are  either  TTL  compatible  or  crystal  compatible  See  crystal  specification  in  Ap- 
plications Information  section. 
All  inputs  except  XTAL/EXT  have  internal  pull-up  resistors, 

NOTE  2:  Refer  to  frequency  option  tables  for  maximum  input  frequency  on  XTAUEXT  pins 
Typical  Clock  Pulse  width  is  1/2xCL 

NOTE  3:  Input  set-up  time  can  be  decreased  to  >0  ns  by  increasing  the  minimum  strobe  width  by  50  ns  to  a  total  of  200  ns 


OPERATION 
Standard  Frequencies 

Choose  a  Transmitter  and  Receiver  frequency  from  the 
table  below.  Program  the  corresponding  address  into  TA- 
TD  and  RA-RD  respectively  using  strobe  pulses  or  by  hard 
wiring  the  strobe  and  address  inputs 


Non-Standard  Frequencies 

To  accomplish  non-standard  frequencies  do  one  of  the 
following: 

1  Choose  a  crystal  that  when  divided  by  the  BR1941 
generates  the  desired  frequency., 

2  Cascade  devices  by  using  the  frequency  outputs  as  an 


391 


CO 
20 


input   to   the   XTAUEXT   inputs  of   the   subsequent 
8R1941 

FREQUENCY  OPTIONS 


3   Consult  the  factory  for  possible  changes  via  ROM  mask 
reprog  ramming 


TABLE  1    CRYSTAL  FREQUENCY 

=   5  0688  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate          Theoretical 
<16X  Clock)    Freq.  (kHz) 

Actual 
Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

s 

A 

0 

0 

0 

0 

50                    0  8 

08 

— 

50/50 

6336 

0 

0 

0 

1 

75                     1.2 

1.2 

™ 

50/50 

4224 

0 

0 

1 

0 

110                   176 

1.76 

_ 

50/50 

2880 

0 

0 

1 

1 

134.5                2.152 

2.1523 

0  016 

50/50 

2355 

0 

1 

0 

0 

150                    2  4 

24 

„ 

50/50 

2112 

o 

1 

0 

1 

300                    4  8 

48 

— 

50/50 

1056 

0 

1 

1 

0 

600                    9.6 

9.6 

™ 

50/50 

528 

0 

1 

1 

1 

1200                  19  2 

192 

— 

50/50 

264 

0 

0 

0 

1800                 28  8 

28.8 

_ 

50/50 

176 

0 

0 

1 

2000                  32  0 

32.081 

0  253 

50/50 

156 

0 

1 

0 

2400                  38  4 

38  4 

™ 

50/50 

132 

0 

1 

1 

3600                  57  6 

57  6 

— 

50/50 

88 

1 

0 

0 

4800                  76.8 

76.8 

„ 

50/50 

66 

1 

0 

1 

7200                 115  2 

1152 

— 

50/50 

44 

1 

1 

0 

UbUU                  1 3 J  b 

5  3  J  D 

„ 

HOI^ 

jo 

1 

1 

1 

19,200               307,2 

316.8 

3.125 

50/50 

16 

TABLE  2 

CLOCK  FREQUENCY  = 

2  76480  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate          Theoretical 
<16X  Clock)    Freq.  (kHz) 

Actual 
Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

o 

0 

0 

0 

50                     0  8 

08 

— 

50/50 

3456 

0 

0 

0 

1 

75                     1,2 

1.2 

— 

50/50 

2304 

0 

0 

1 

0 

110                   176 

1  76 

-0  006 

50/50 

1571 

0 

0 

1 

1 

134.5                2.152 

2.152 

-0019 

50/50 

1285 

o 

1 

0 

0 

150                    2  4 

24 

„ 

50/50 

1152 

0 

1 

0 

1 

200                    3  2 

32 

— 

50/50 

864 

0 

1 

1 

0 

300                    4  8 

48 

_. 

50/50 

576 

o 

1 

1 

1 

600                    9.6 

9.6 

„ 

50/50 

286 

0 

0 

0 

1200                  19  2 

19  2 

— 

50/50 

144 

0 

0 

1 

1800                  28  8 

28.8 

„_ 

50/50 

96 

0 

1 

0 

2000                  32  0 

32.15 

+  0  465 

50/50 

86 

0 

1 

1 

2400                  38  4 

38  4 

— 

50/50 

72 

1 

0 

0 

3600                  57  6 

57  6 

™ 

50/50 

48 

1 

0 

1 

4800                  76.8 

76.8 

— 

50/50 

36 

1 

1 

0 

9600                 153  6 

153  6 

™ 

50/50 

18 

1 

1 

1 

19,200               307.2 

307.2 

- 

50/50 

9 

BR1941-02 


TABLE  3   CRYSTAL  FREQUENCY   = 

6018305  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate          Theoretical 
(16X  Clock)    Freq.  (kHz) 

Actual           Percent 
Freq.  (kHz)         Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                     0.8 

,7999                   0 

50/50 

7523* 

0 

0 

0 

75                      1.2 

1.2000                  0 

50/50 

5015* 

o 

0 

1 

110                    1.76 

17597                  0 

50/50 

3420 

0 

0 

1 

134.5                 2.152 

2  1517                  0 

50/50 

2797* 

o 

1 

0 

150                     2  4 

2  3996                  0 

50/50 

2508 

0 

1 

0 

200                     3  2 

31995                  0 

50/50 

1881* 

o 

1 

1 

300                     4  8 

4  7993                  0 

50/50 

1254 

o 

1 

1 

600                     9.6 

9.5986                  0 

50/50 

627* 

0 

0 

1200                   19  2 

19  2279             +0.14 

50/50 

31.3" 

0 

0 

1800                   28  8 

28  7959                 0 

50/50 

209* 

0 

1 

2000                   32  0 

320125                 0 

50/50 

188 

0 

1 

2400                   38  4 

38  3334             -0  17 

50/50 

157* 

1 

0 

3600                   57  6 

57  8687             +0  46 

50/50 

104 

1 

0 

4800                   76.8 

77.1583             +046 

50/50 

78 

1 

1 

9800                 153  6 

154  3166            +0  46 

50/50 

39' 

1 

1 

19,200               307.2 

300.9175            -2.04 

50/50 

20 

BR1941-03 
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TABLE  4 

CLOCK  FREQUENCY  = 

5  52960  MHZ 

Transmit/Receive 

Baud 

Rate         Theoretical 
(16X  Clock)    Freq.  (kHz) 

Address 

Actual 
Freq.  (kHz) 

Percent 
Error 

Duty 
Cycle 

% 

CO 

D 

C 

B 

A 

Divisor 

30 

0 

0 

0 

0 

50                    1.6 

16 

_ 

50/50 

3456 

CO 

0 

0 

0 

1 

76                    2.4 

2.4 

— 

50/50 

2304 

■ft* 

0 

0 

0 

110                  3.52 

3.52 

-0  006 

50/50 

1571 

JZ*t 

0 

0 

1 

134.5               4  304 

4  303 

-0019 

50/50 

1285 

Ol 

0 

1 

0 

150                   48 

48 

_ 

50/50 

1152 

o 

1 

1 

200                   6  4 

6.4 

— 

50/50 

864 

3 

1 

0 

300                   9.6 

9.6 

— 

50/50 

576 

1 

1 

600                  19  2 

19  2 

— 

50/50 

288 

0 

0 

1200                 38  4 

38  4 

— 

50/50 

144 

0 

1 

1800                 57  6 

57.6 

_ 

50/50 

96 

0 

0 

2000                 64  0 

64  3 

+  0  465 

50/50 

86 

0 

1 

2400                 76.8 

76.8 

— 

50/50 

72 

1 

0 

3600                115  2 

1152 

_ 

50/50 

48 

1 

1 

4800                153  6 

153  6 

_ 

50/50 

36 

1 

0 

9600                307  2 

307  2 

_ 

50/50 

18 

1 

1 

19,200              614.4 

614.4 

_ 

50/50 

9 

BR1941-04 

TABLE  5,  CRYSTAL  FREQUENCY  =  4  9152  MHZ 


Transmit/Receive 
Address 

Baud 

Actual 
Freq.  (kHz) 

Percent 
Error 

Duty 
Cycle 

% 

D 

C 

B 

A 

(32X  Clock)     Freq.  (kHz) 

Divisor 

0 

0 

0 

0 

50                   0  8 

08 

— 

50/50 

6144 

0 

0 

0 

75                    1.2 

1.2 

_ 

50/50 

4096 

0 

0 

1 

110                  176 

1.7598 

-0  01 

* 

2793 

0 

0 

1 

134,5                2,152 

2.152 

— 

50/50 

2284 

0 

1 

0 

150                   2  4 

2.4 

— 

50/50 

2048 

0 

1 

0 

300                   48 

48 

— 

50/50 

1024 

0 

1 

1 

600                   9.6 

9.6 

— 

50/50 

512 

0 

1 

1 

1200                 192 

19.2 

_ 

50/50 

256 

0 

0 

1800                 28  8 

28  7438 

-019 

171 

0 

0 

2000                 32  0 

31.9168 

-0  26 

50/50 

154 

0 

1 

2400                 38  4 

38.4 

_ 

50/50 

128 

0 

1 

3600                 57  6 

57.8258 

0  39 

85 

1 

0 

4800                 76.8 

76.8 

__ 

50/50 

64 

1 

0 

7200                115  2 

114.306 

-0  77 

• 

43 

1 

1 

9600                153.6 

153  6 

_ 

50/50 

32 

1 

1 

19,200               307.2 

307,2 

— 

50/50 

16 

BR1941-05 

TABLE  6.  ( 

CRYSTAL  FREQUENCY 

=  50688  MHZ 

Transmit/Receive 
Address 

Baud 

Actual 
Freq.  (kHz) 

Percent 

Error 

Duty 
Cycle 

% 

D 

c 

B 

A 

(32X  Clock)     Freq.  (kHz) 

Divisor 

0 

0 

0 

0 

50                    1.6 

16 

™ 

50/50 

3168 

0 

0 

0 

1 

75                    2.4 

2.4 

__ 

50/50 

2112 

0 

0 

0 

110                  3.52 

3.52 

_ 

50/50 

1440 

0 

0 

1 

134.5               4  304 

4..303 

026 

50/50 

1178 

0 

1 

0 

150                   48 

48 

_ 

50/50 

1056 

0 

1 

1 

200                   6.4 

64 

_ 

50/50 

792 

0 

1 

0 

300                   9.6 

9.6 

_ 

50/50 

528 

0 

1 

1 

600                  19  2 

192 

— 

50/50 

264 

0 

0 

1200                 38  4 

38  4 

— 

50/50 

132 

0 

1 

1800                 57  6 

57  6 

_ 

50/50 

88 

0 

0 

2400                 76.8 

76,8 

_ 

50/50 

66 

0 

1 

3600                115  2 

115  2 

_ 

50/50 

44 

1 

0 

4800                153  6 

153  6 

_ 

33 

1 

1 

7200                230  4 

230  4 

„ 

50/50 

22 

1 

0 

9600                307  2 

298.16 

2  941 

17 

1 

1 

19,200              614.4 

633.6 

3.125 

50/50 

8 

•When  the  d 

uty  cycle  is  not  exactly 

50%  It  is  5 

0%   ±    10% 

BR1941-Q6 
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CRYSTAL  SPECIFICATIONS 

User  must  specify  termination  (pin,  wire,  other) 
Frequency  —  See  Tables  1-6. 
TemperaturerangeO°Cto  +  70°C 
Series  resistance  <  50Q 
Series  resonant 
Overall  tolerance  ±  .01  % 

CRYSTAL  MANUFACTURERS  (Partial  List) 

American  Time  Products  Div 
Frequency  Control  Products,  Inc 
61-20  Woodstde  Ave 
Woodside,  New  York  1 1377 
(212)458-5811 


Biiiey  Electric  Co 
2545  Grandview  Blvd 
Erie,  Pennsylvania  16508 
(814)838-3571 

M-tronSnd  Inc, 

RO,  Box  630 

Yankton,  South  Dakota  57078 

(605)665-9321 

Erie  Frequency  Control 

453  Lincoln  St 

Calisle,  Pennsylvania  17013 

{714)249-2232 


APPLICATIONS  INFORMATION 


OPERATION  WITH  A  CRYSTAL 

The  BR1941  Baud  Rate  Generator  may  be  driven  by  either  a 
crystal  or  TTL  level  clock  When  using  a  crystal,  the  wave- 
form that  appears  at  pins  1  (XTAL/EXT 1)  and  18  (XTAUEXT 
2)  does  not  conform  to  the  normal  TTL  limits  of  Vjl  <  0.8V 
and  Vm  >  20V,  Figure  1  illustrates  a  typical  crystal 
waveform  when  connected  to  a  BR1941 

Since  the  DC  level  of  the  waveform  causes  the  least 
positive  point  to  typically  be  greater  than  0„8V,  the  BR1941 
is  designed  to  look  for  an  edge,  as  opposed  to  a  TTL  level. 
The  XTAUEXT  logic  triggers  on  a  rising  edge  of  typically  1 V 
in  magnitude.  This  allows  the  use  of  a  crystal  without  any 
additional  components 

OPERATIONS  WITH  TTL  LEVEL  CLOCK 

With  clock  frequencies  in  the  area  of  5  MHz,  significant 
overshoot  and  undershoot  ("ringing")  can  appear  at  pins  1 
and/or  18  The  BR1941,  may,  at  times,  be  triggered  on  a 
rising  edge  of  an  overshoot  or  undershoot  waveform, 
causing  the  device  to  effectively  "double-trigger "  This 
phenomenon  may  result  as  a  twice  expected  baud  rate,  or 
as  an  apparent  device  failure.  Figure  2  shows  a  typical 
waveform  that  exhibits  the  "ringing"  problem, 
The  design  methods  required  to  minimize  ringing  include 
the  following: 

1  Minimize  the  PC  trace  length  At  5  MHz,  each  inch  of 
trace  can  add  significantly  to  overshoot  and  undershoot 

2  Match  impedances  at  both  ends  of  the  trace  For 
example,  a  series  resistor  near  the  BR1941  may  be 
helpful 

3..  A  uniform  impedance  is  important  This  can  be  ac- 
complished through  the  use  of: 


a   parallel  ground  lines 

b  evenly  spaced  ground  lines  crossing  the  trace  on  the 

opposite  side  of  PC  board 
c   an  inner  plane  of  ground,  eg,  as  in  a  four  layered  PC 

board 

In  the  event  that  ringing  exists  on  an  already  finished 
board,  several  techniques  can  be  used  to  reduce  it  These 

are: 

1.  Add  a  series  resistor  to  match  impedance  as  shown  in 
Figure  3 

2  Add  puil-up/pull-down  resistor  to  match  impedance,  as 
shown  in  Figure  4, 

3  Add  a  high  speed  diode  to  clamp  undershoot,  as  shown 
in  Figure  5 

The  method  that  is  easiest  to  implement  in  many  systems 
is  method  1,  the  series  resistor  The  series  resistor  will 
cause  the  DC.  level  to  shift  up,  but  that  does  not  cause  a 
problem  since  the  BR1941  is  triggered  by  an  edge,  as 
opposed  to  a  TTL  level 

The  BR1941  Baud  Rate  Generator  can  save  both  board 
space  and  cost  in  a  communications  system  By  choosing 
either  a  crystal  or  a  TTL  level  clock,  the  user  can  minimize 
the  iogic  required  to  provide  baud  rate  clocks  in  a  given 
design 

POWER  LINE  SPIKES 

Voltage  transients  on  the  AC  power  line  may  appear  on  the 
DC  power  output  tf  this  possibility  exists,  it  is  suggested 
that  one  by-pass  capacitor  is  used  between  +  5V  and  GND 
and  another  between  +  12V  and  GND 
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Figure  1  TYPICAL  CRYSTAL  WAVEFORM 


Figure  2  TYPICAL  "RINGING"  WAVEFORM 


Typical  Values 
R1  '■  R2  *  3311 


Figure  3  SERIES  RESISTOR  TO  MATCH  IMPEDANCE 


Typical  Values 
R1  -  R3  -  ?  7K 
R2  =  fW  =  3  3K 


Figure  4  PULL-UP/PULL-DOWN  RESISTORS  TO  MATCH  IMPEDANCE 

_H> 


Figure  5  HIGH-SPEED  DIODE  TO  CLAMP  UNDERSHOOT 


See  page  725  for  ordering  information,, 
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Information  furnished  by  Western  Digital  Corporation  is  beiieved  to  be  accurate  and  reliable  However,  no  responsibility  is  assumed  by  Western  Digital 
Corporation  lor  its  use  nor  lor  any  infringements  of  patents  or  other  rights  of  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  patent  rights  of  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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WEST,  DiGtTAL 

CORPORATfON 

WD1943(8116)/WD1945(8136)  Dual  Baud  Rate  Clock 


FEATURES 

•  16  SELECTABLE  BAUD  RATE  CLOCK  FREQUENCIES 
•OPERATES  WITH  CRYSTAL  OSCILLATOR  OR  EX- 
TERNALLY GENERATED  FREQUENCY  INPUT 

•  ROM  MASKABLE  FOR  NON-STANDARD  FREQUENCY 
SELECTIONS 

♦INTERFACES  EASILY  WITH  MICROCOMPUTERS 
•OUTPUTS  A  50%  DUTY  CYCLE  CLOCK  WITH  001% 
ACCURACY 

•6  DIFFERENT  FREQUENCY/DIVISOR  PAIRS 

AVAILABLE 
•SINGLE  +5V  POWER  SUPPLY 

•  COMPATIBLE  WITH  BR1941 
•TTL,  MOS  COMPATIBILITY 

•  WD1943  IS  PIN  COMPATIBLE  TO  THE  COM81 16 

•  WD1945  IS  PIN  COMPATIBLE  TO  THE  COM8136  AND 
COM5036  (PIN  9  ON  WD1945  IS  A  NO  CONNECT) 


GENERAL  DESCRIPTION 

The  WD1943/45  is  an  enhanced  version  of  the  BR1941  Dual 
Baud  Rate  Clock  The  WD1943/45  is  a  combination  Baud 
Rate  Clock  Generator  and  Programmable  Divider  it  is 
manufactured  in  N-channel  MOS  using  silicon  gate 
technology  This  device  is  capable  of  generating  16  ex- 
ternally selected  clock  rates  whose  frequency  is  deter- 
mined by  either  a  single  crystal  or  an  externally  generated 
input  clock  The  WD1943/45  is  a  programmable  counter 
capable  of  generating  a  division  by  any  integer  from  4  to 
215-~  1,  inclusive. 

The  WD1943/45  is  available  programmed  with  the  most 
used  frequencies  in  data  communication  Each  frequency 
is  selectable  by  strobing  or  hard  wiring  each  of  the  two  sets 
of  four  Rate  Select  inputs  Other  frequencies/division  rates 
can  be  generated  by  reprogramming  the  interna!  ROM 
coding  through  a  MOS  mask  change  Additionally,  further 
clock  division  may  be  accomplished  through  cascading  of 
devices  The  frequency  output  is  fed  into  the  XTAUEXT 
input  on  a  subsequent  device 

The  WD1943/45  can  be  driven  by  an  external  crystal  or  by 
TTL  logic. 
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PIN  DESCRIPTION 
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PIN  NUMBER 

SYMBOL 

NAME 

FUNCTION 

1 

XTAUEXT 1 

Crystal  or 
External  Input  1 

This  input  receives  one  pin  of  the  crystal  package  or  one 
polarity  of  the  external  input. 

2 

vcc 

Power  Supply 

+  5  volt  Supply 

3 

m 

Receiver  Output 
Frequency 

This  output  runs  at  a  frequency  selected  by  the  Receiver 
Address  inputs 

4-7 

Ra,  Rb.  rc,  Rd 

Receiver  Address 

The  logic  level  on  these  inputs  as  shown  in  Table  1  thru  6, 
selects  the  receiver  output  frequency,  fR. 

8 

STR 

Strobe-Receiver 
Address 

A  high-level  input  strobe  loads  the  receiver  address  (Ra»  Rb> 
Rc,  Rd)  into  the  receiver  address  register  This  input  may  be 

strobed  or  hard  wired  to  +  5V 

9 

NC 

No  Connection 

No  Internal  Connection 

10 

NC{1943) 
1/4(1945) 

No  Connection 
(req/4  Output 

No  Internal  Connection 
XTAL1  input  freq  divided  by  four 

11 

GND 

Ground 

Ground 

1? 

STT 

Strobe-Transmitter 
Address 

A  hiqh-ievel  input  strobe  loads  the  transmitter  address  (Ta. 
Tb,  Tc,  Tq)  into  the  transmitter  address  register.  This  input 
may  be  strobed  or  hard  wired  to  +  5V 

13-16 

TO.  Tc,  Tb,  Ta 

Transmitter 
Address 

The  logic  level  on  these  inputs,  as  shown  in  Table  1  thru  6, 
selects  the  transmitter  output  frequency,  fj 

17 

fj 

Transmitter 

Output 

Frequency 

This  output  runs  at  a  frequency  selected  by  the  Transmitter 

Address  inputs 

18 

XTAUEXT  2 

Crystal  or 
External 
Input  2 

This  input  receives  the  other  pin  of  the  crystal  package  or  the 
other  polarity  of  the  external  input 

CONTROL  TIMING 


\ 

STROBE              /             3 
(STR/STTl            '            X 

c 

\ 

^SET-UP  — »- 

SEE  NOTE  t 

PAGE  3 

V.H ^ 

ADOflESS           \ 

VIL  ' 

ADORES 
TPWTIM 

J 

< 

-*HOL0 

t 

* 

a  NEED  ONLY  B£  VALID  OURtNG  THE  L 
E  OF  THEIUPUT  STROBE 

CRYSTAL  OPERATION 
WD1943/45 


EXTERNAUNPUT  OPERATION 
WD1943/45 


I iDl 1  i p>o 1  j  I 


M  POLE  OR  OPEN  COLLECTOR  OUTPUT 


CRYSTAL/CLOCK  OPTIONS 


ABSOLUTE  MAXIMUM  RATINGS 

Positive  Voltage  on  any  Pin,  with  respect  to  ground 
Negative  Voltage  on  any  Pin,  with  respect  to  ground 
Storage  Temperature 


+  7  0V 
-0\3V 


(plastic package)  ~55°Cto  +125°C 
(Cerdip  package  and  Ceramic  package)  -  65°C  to  +  150°C 


Lead  Temperature  (Soldering,  10  sec ) 

•Stresses  above  those  listed  may  cause  permanent  damage  to  the  device.  This  is  a  stress 
rating  only  and  Functional  Operation  of  the  device  at  these  or  at  any  other  condition 
above  those  indicated  in  the  operational  sections  of  this  specification  are  not  implied 


+  325°C 
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ELECTRICAL  CHARACTERISTICS   Oa 

=  0°Cto  +70°ClVcc=  +5V  ±5% 

standard .) 

PARAMETER 

M1N 

TYP 

MAX 

UNIT 

COMMENTS 

DC  CHARACTERISTICS 

IN  PUT  VOLTAGE  LEVELS 

Low-level,  V|L 
High-level,  Vih 

2  0 

08 

vcc 

V 

V 

See  Note  1 

OUTPUT  VOLTAGE  LEVELS 

Low- level,  Vol 
High-level.  Voh 

Vcc-1-5 

4.0 

0.4 

V 
V 

lOL  =  3.2  mA 
lOH  =  10QnA 

INPUT  CURRENT 
High-level,  I|h 

Low-level,  l|L 

Low-level,  Ijl 

-10 
10 
300 

10 

^A 
MA 
MA 

V|N  =  Vcc    STR  {8}  and  STT  (12) 

V|N  =  GND    Only 

V)N  =  GND    (All  inputs  except 

XTAL,  STR  and  STT) 
V|N  =  GND  STR,  STT 

INPUT  CAPACITANCE 
AM  Inputs,  Cjfg 

5 

10 

P* 

V|M  =  GND,  excluding  XTAL  inputs 

EXT  INPUT  LOAD 

4 

5 

Series  7400  unit  loads 

INPUT  RESISTANCE 
Crystal  Input,  RxTAL 

POWER  SUPPLY  CURRENT 
*CC 

1.1 

40 

80 

KQ 

rnA 

Resistance  to  ground  for 
Pin  1  and  Pin  18 

AC  CHARACTERISTICS 

TA  =  +25°C 

CLOCK  FREQUENCY 

See  Note  2 

PULSE  WIDTH  (Tpw) 
Clock 

Receiver  strobe 
Transmitter  strobe 

150 
150 

DC 
DC 

ns 
ns 

50%  Duty  Cycle  ±  10%.  See  Note  2 
See  Note  3 
See  Note  3 

INPUT  SET-UPTIME  (TSET-UP> 

Address 

50 

ns 

See  Note  3 

OUTPUT  HOLD  TIME  (THOLD) 
Address 

50 

ns 

STROBE  TO  NEW  FREQUENCY 
DELAY 

6 

CLK 

2 

CO 
00 


CO 

.fei 

00 
CO 

.03 


NOTE  1:  XTAL/EXT  inputs  are  either  TTL  compatible  or  crystal  compatible  See  crystal  specification  in 

Applications  Information  section. 

All  inputs  except  XTAL,  STR  and  STT  have  internal  pull-up  resistors 
NOTE  2:  Refer  to  frequency  option  tables  for  maximum  input  frequency  on  XTAL/EXT  pins 

Typical  clock  pulse  width  is  1/2  x  CL 
NOTE  3:  Input  set-up  time  can  be  decreased  to  >0  ns  by  increasing  the  minimum  strobe  width  (50  ns)  to  a  total  of  200  ns. 

T/v-Q  and  Ra-D  have  internal  pull-up  resistors 


OPERATION 

Standard  Frequencies 

Choose  a  Transmitter  and  Receiver  frequency  from  the 
table  below.  Program  the  corresponding  address  intoTA-TD 
and  RA-RD  respectively  using  strobe  pulses  or  by  hard 
wiring  the  strobe  and  address  inputs 


Non-Standard  Frequencies 

To  accomplish  non-standard  frequencies  do  one  of  the 
following: 

1.  Choose  a  crystal  that  when  divided  by  the  WD1943 
generates  the  desired  frequency. 

2  Cascade  devices  by  using  the  frequency  outputs  as  an 
input  to  the  XTAL/EXT  inputs  of  the  subsequent 
WD1943/45 

3  Consult  the  factory  for  possible  changes  via  ROM  mask 
reprog  ramming 
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FREQUENCY  OPTIONS 


TABLE  1  CRYSTAL  FREQUENCY 

-  5.0688  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate         Theoretical 
(16X  Clock)    Freq.  (kHz) 

Actual 

Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                  0  8 

0  8 

— 

50/50 

6336 

0 

0 

0 

75                   1.2 

1.2 

_ 

50/50 

4224 

0 

0 

110                 1.76 

1.76 

— 

50/50 

2880 

0 

0 

134.5               2.152 

21523 

0.016 

50/50 

2355 

0 

1 

150                  2,4 

2.4 

_ 

50/50 

2112 

0 

1 

300                  4  8 

48 

— 

50/50 

1056 

0 

1 

600                  9.6 

9.6 

_ 

50/50 

528 

0 

1 

1200                 192 

192 

_~ 

50/50 

264 

0 

1800                 28  8 

28.8 

_ 

50/50 

176 

0 

2000                 32  0 

32.081 

0  253 

50/50 

158 

0 

2400                 38.4 

38  4 

— 

50/50 

132 

0 

3600                57,6 

57  6 

_ 

50/50 

88 

1 

4800                76.8 

76.8 

_ 

50/50 

66 

1 

7200               115.2 

115.2 

— 

50/50 

44 

1 

9600                1536 

1536 

— 

48/52 

33 

1 

19,200              307.2 

316.8 

3.125 

50/50 

16 

WD1943-00  or  WD1945-00 


TABLE  2   CLOCK  FREQUENCY  = 

2.76480  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate         Theoretical 
(16X  Clock)    Freq.  (kHz) 

Actual 
Freq.  (kHz) 

Percent 
Error 

Cycle 

% 

Divisor 

D 

C 

B 

A 

0 

0 

0 

0 

50                  0  8 

0.8 

_ 

50/50 

3456 

0 

0 

0 

75                   1.2 

1.2 

__ 

50/50 

2304 

0 

0 

110                 1.76 

1.76 

-  0 .006 

50/50 

1571 

0 

0 

134.5               2.152 

2.152 

-0.019 

50/50 

1285 

o 

1 

150                  24 

24 

_ 

50/50 

1152 

o 

1 

200                   3  2 

3  2 

_ 

50/50 

864 

o 

1 

300                   4  8 

4  8 

— 

50/50 

576 

o 

1 

600                   9.6 

9.6 

_ 

50/50 

288 

0 

1200                 19  2 

192 

— 

50/50 

144 

0 

1800                28  8 

28.8 

— 

50/50 

96 

0 

2000                32.0 

32.15 

+  0  465 

50/50 

86 

0 

2400                38,4 

384 

_ 

50/50 

72 

1 

3600                57.6 

576 

_ 

50/50 

48 

1 

4800                76.8 

76.8 

__ 

50/50 

36 

1 

0 

9600               153.6 

153  6 

_ 

50/50 

18 

1 

19,200              307.2 

307.2 

— 

50/50 

9 

WD1943-02orWD1945-02 


TABLE  3  CRYSTAL  FREQUENCY  = 

6.018305  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate         Theoretical 
<16X  Clock)    Freq.  (kHz) 

Actual           Percent 
Freq.  (kHz)         Error 

Cycle 

% 

Divisor 

D 

C 

8 

A 

o 

0 

0 

0 

50                  0.8 

.7999                  0 

50/50 

7523* 

0 

0 

0 

75                   1.2 

1  2000                 0 

50/50 

5015" 

o 

o 

110                 1.76 

1  7597                 0 

50/50 

3420 

o 

o 

134,5               2.152 

2.1517                 o 

50/50 

2797* 

o 

1 

150                   24 

2.3996                 0 

50/50 

2508 

o 

1 

200                  3  2 

3  1995                 0 

50/50 

1881* 

o 

1 

300                  4,.8 

4.7993                 0 

50/50 

1254 

o 

1 

600                  9.6 

9.5986                 0 

50/50 

627* 

o 

1200                 19,2 

192279             +0,14 

50/50 

31.3* 

o 

1800                 28,8 

28  7959                 0 

50/50 

209* 

0 

2000                 32  0 

32  0125                 0 

50/50 

188 

o 

2400                 38.4 

38  3334             -017 

50/50 

157" 

1 

3600                 576 

57  8687             +0.46 

50/50 

104 

1 

4800                 76.8 

77.1583             +0  46 

50/50 

78 

1 

0 

9800                153.6 

154  3166            +0,46 

50/50 

39* 

1 

19,200               307.2 

300.9175            -2.04 

50/50 

20 

WD1943-03  or  WD1945-03 
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TABLE  4 

CLOCK  FREQUENCY  = 

5  52960  MHZ 

Transmlu'Recelve 

Baud 

Duty 

Cycle 

% 

Address 

Rate         Theoretical 

D 

c 

B 

A 

(32X  Clock)    Freq.  (kHz) 

Freq.  (kHz) 

Error 

Divisor 

0 

0 

0 

0 

50                    1.6 

16 

_ 

50/50 

3456 

0 

0 

0 

1 

75                   2.4 

2.4 

_ 

50/50 

2304 

0 

0 

1 

0 

110                 3.52 

3.52 

-0  006 

50/50 

1571 

0 

0 

1 

1 

134.5               4  304 

4,303 

-0019 

50/50 

1285 

0 

1 

0 

0 

150                  4.8 

48 

_ 

50/50 

1152 

0 

1 

0 

1 

200                   6  4 

64 

_ 

50/50 

864 

0 

1 

1 

0 

300                   9.6 

9.6 

_ 

50/50 

576 

0 

1 

1 

1 

600                  19  2 

192 

_ 

50/50 

288 

0 

0 

0 

1200                 38  4 

38  4 

_ 

50/50 

144 

0 

0 

1 

1800                 57  6 

57  6 

_ 

50/50 

96 

0 

1 

0 

2000                 64  0 

64.,3 

+  0  465 

50/50 

86 

0 

1 

1 

2400                 76.8 

76.8 

_ 

50/50 

72 

1 

0 

0 

3600                115  2 

115.2 

_ 

50/50 

48 

1 

0 

1 

4800                153  6 

153  6 

_ 

50/50 

36 

1 

1 

0 

9600                3072 

307  2 

_ 

50/50 

18 

1 

1 

1 

19,200              614.4 

614.4 

— 

50/50 

9 

WD1943-04orWDl945-04 


TABLE  5.  CRYSTAL  FREQUENCY 

=  4  9152  MHZ 

Transmit/Receive 

Baud 

Duty 

Address 

Rate         Theoretical 

Actual 

Percent 

Cycle 

D 

C 

B 

A 

(16X  Clock)    Fraq.  (kHz) 

Freq.  (kHz) 

Error 

% 

Divisor 

0 

0 

0 

0 

50                  0  8 

08 

— 

50/50 

6144 

0 

0 

0 

1 

75                    1.2 

1.2 

— 

50/50 

4096 

0 

0 

1 

0 

1 10                  1  76 

1.7598 

-0  01 

* 

2793 

0 

0 

1 

1 

134.5               2.152 

2.152 

_ 

50/50 

2284 

0 

1 

0 

0 

150                   24 

2  4 

™ 

50/50 

2048 

0 

1 

0 

1 

300                   4  8 

48 

_ 

50/50 

1024 

0 

1 

1 

0 

600                   9.6 

9.6 

__ 

50/50 

512 

0 

1 

1 

1 

1200                 19  2 

19.2 

_ 

50/50 

256 

0 

0 

0 

1800                 28  8 

28  7438 

-0  19 

• 

171 

0 

0 

1 

2000                 32  0 

31.9168 

-0  26 

50/50 

154 

0 

1 

0 

2400                 38  4 

38.4 

_ 

50/50 

128 

0 

1 

1 

3600                 57,6 

57.8258 

0,39 

85 

1 

0 

0 

4800                 76.8 

76.8 

™ 

50/50 

64 

1 

0 

1 

7200                115  2 

114.306 

-0  77 

43 

1 

1 

0 

9600                153  6 

153  6 

— 

50/50 

32 

1 

1 

1 

19,200              307.2 

307.2 

— 

50/50 

16 

WD1 943-05  or  WD1 945-05 


TABLE  6. 

0RYSTAL  FREQUENCY 

=  5,0688  MHZ 

Transmit/Receive 

Baud 

Duly 

Address 

Rate         Theoretical 

Actual 

Percent 

Cycle 

D 

C 

B 

A 

(32X  Clock)    Freq.  (kHz) 

Freq.  (kHz) 

Error 

% 

Divisor 

0 

0 

0 

0 

50                  16 

16 

_ 

50/50 

3168 

0 

0 

0 

1 

75                   2.4 

2.4 

__ 

50/50 

2112 

0 

0 

1 

0 

110                  3.52 

3.52 

_ 

50/50 

1440 

0 

0 

1 

1 

134.5               4  304 

4,303 

026 

50/50 

1178 

0 

1 

0 

0 

150                   4  8 

4  8 

_ 

50/50 

1056 

0 

1 

0 

1 

200                   6  4 

64 

_ 

50/50 

792 

0 

1 

1 

0 

300                   9.6 

9.6 

_, 

50/50 

528 

0 

1 

1 

1 

600                  19,2 

192 

— 

50/50 

264 

0 

0 

0 

1200                 384 

384 

— 

50/50 

132 

0 

0 

1 

1800                 57  6 

57  6 

— 

50/50 

88 

0 

1 

0 

2400                 76.8 

76.8 

— 

50/50 

66 

0 

1 

1 

3600               115  2 

1152 

„ 

50/50 

44 

1 

0 

0 

4800                153  6 

1536 

_ 

33 

1 

0 

1 

7200                230  4 

230  4 

_ 

50/50 

22 

1 

1 

0 

9600                307  2 

298.16 

2941 

* 

17 

1 

1 

1 

19,200              614.4 

633.6 

3.125 

50/50 

8 

•When  the  duty  cycle  Is  not  exactly  50%  it  is  50%   ±   10% 


WD1943-06orWD1945-06 
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APPLICATIONS  INFORMATION 
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OPERATION  WITH  A  CRYSTAL 

The  WD  1943/45  Baud  Rate  Generator  may  be  driven  by 
either  a  crystal  or  TTL  level  clock  When  using  a  crystal,  the 
waveform  that  appears  at  pins  1  (XTAL/EXT  1)  and  18 
(XTAUEXT  2)  does  not  conform  to  the  normal  TTL  limits  of 
Vjl  <  08V  and  V(H  >  2,0V  Figure  1  illustrates  a  typical 
crystal  waveform  when  connected  to  a  WD1943/45 

Since  the  DC.  level  of  the  waveform  causes  the  least 
positive  point  to  typically  be  greater  than  0.8V,  the 
WD1943/45  is  designed  to  look  for  an  edge,  as  opposed  to  a 
TTL  level.  The  XTAUEXT  logic  triggers  on  a  rising  edge  of 
typically  1V  in  magnitude  This  allows  the  use  of  a  crystal 
without  any  additional  components 

OPERATIONS  WITH  TTL  LEVEL  CLOCK 

With  clock  frequencies  in  the  area  of  5  MHz,  significant 
overshoot  and  undershoot  {"ringing")  can  appear  at  pins  1 
and/or  18  The  clock  oscilator  may,  at  times  be  triggered  on 
a  rising  edge  of  an  overshoot  or  undershoot  waveform, 
causing  the  device  to  effectively  -'double-trigger.''  This 
phenomenon  may  result  as  a  twice  expected  baud  rate,  or 
as  an  apparent  device  failure  Figure  2  shows  a  typical 
waveform  that  exhibits  the  "ringing"  problem 

The  design  methods  required  to  minimize  ringing  include 
the  following: 

1.  Minimize  the  PC,  trace  length  At  5  MHz,  each  inch  of 
trace  can  add  significantly  to  overshoot  and  undershoot. 

2.  Match  impedances  at  both  ends  of  the  trace  For 
example,  a  series  resistor  near  the  device  may  be 
helpful 

3.  A  uniform  impedance  is  important  This  can  be  ac- 
complished through  the  use  of: 

a  parallel  ground  lines 

b_  evenly  spaced  ground  lines  crossing  the  trace  on  the 

opposite  side  of  PC  board 
a  an  inner  plane  of  ground,  eg.,  as  in  a  four  layered  PC 

board,. 

In  the  event  that  ringing  exists  on  an  already  finished 
board,  several  techniques  can  be  used  to  reduce  it  These 
are: 

1  Add  a  series  resistor  to  match  impedance  as  shown  in 
Figure  3. 

2,  Add  puM-up/putl-down  resistof  to  match  impedance,  as 
shown  in  Figure  4, 

3,  Add  a  high  speed  diode  to  clamp  undershoot,  as  shown 
in  Figure  5, 


The  method  that  is  easiest  to  implement  in  many  systems 
is  method  1,  the  series  resistor  The  series  resistor  will 
cause  the  D  C  level  to  shift  up,  but  that  does  not  cause  a 
problem  since  the  OSC  is  triggered  by  an  edge,  as  opposed 
to  a  TTL  level 


The  1943/45  Baud  Rate  Generator  can  save  both  board 
space  and  cost  in  a  communications  system  By  choosing 
either  a  crystal  or  a  TTL  level  clock,  the  user  can  minimize 
the  logic  required  to  provide  baud  rate  clocks  in  a  given 
design 


POWER  LINE  SPIKES 

Voltage  transients  on  the  AC  power  line  may  appear  on  the 
DC  power  output  If  this  possibility  exists,  it  is  suggested 
that  a  by-pass  capacitor  is  used  between  +  5V  and  GND 


CRYSTAL  SPECIFICATIONS 

User  must  specify  termination  (pin,  wire,  other) 

Frequency  —  See  Tables  1-6. 

Temperature  range  0°C  to  +  70oC 

Series  resistance  <  5052 

Series  resonant 

Overall  tolerance  ±  0  01% 


CRYSTAL  MANUFACTURERS  (Partial  List) 

American  Time  Products  Div 
Frequency  Control  Products,  Inc.. 
61-20  Woodside  Ave 
Woodside,  New  York  1 1377 
(213)458-5811 

Bliley  Electric  Co. 
2545  Grandview  Blvd 
Erie,  Pennsylvania  16508 
(814)838-3571 

M-trontnd  .Inc. 

P,0  Box  630 

Yankton,  South  Dakota  57078 

(605)665-9321 

Erie  Frequency  Control 

453  Lincoln  St 

Caiisle,  Pennsylvania  17013 

(714)249*2232 
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Figure  1.  TYPICAL  CRYSTAL  WAVEFORM 


Figure  2,  TYPICAL  "RINGING"  WAVEFORM 
from  TTL  INPUT 


3» 
O 

CO 
00 


2 

CD 

m 

CO 
CO 


Figure  3,  SERIFS  RESISTOR  TO  MATCH  IMPEDANCE 


^ 


Typical  Values 
R1  =  R3  =  27K 
R2  =  FU  =  3  3K 


Figure  4.  PULL-UP/PULL-DOWN  RESISTORS  TO  MATCH  IMPEDANCE 

— 1> 


Figure  5,  HIGHSPEED  DIODE  TO  CLAMP  UNDERSHOOT 


See  page  725  for  ordering  information 


o 

Mi 

CO 

00 


CD 

00 
00 


Iniormation  furnished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliabie  However,  no  responsibility  is  assumed  by  Western  Digital 
Corporation  (or  its  use;  nor  lor  any  infringements  of  patents  or  other  rights  ol  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  paten!  or  patent  rights  ol  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  fight  to  change 
specifications  at  anytime  without  notice 
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WESTEffm  DtGITAL 

CORPORAT/ON 

FD179X-02 
Floppy  Disk  Formatter/Controller  Family 


TWO  VFO  CONTROL  SIGNALS  —  RG  &  VFOE 
SOFT  SECTOR  FORMAT  COMPATIBILITY 
AUTOMATIC  TRACK  SEEK  WITH  VERIFICATION 
ACCOMMODATES  SINGLE  AND  DOUBLE  DENSITY 
FORMATS 

IBM  3740  Single  Density  (FM) 

IBM  System  34  Double  Density  (MFM) 

Non  IBM  Format  for  Increased  Capacity 
READ  MODE 
Single/Multiple  Sector  Read  with  Automatic  Search  or 

Entire  Track  Read 
Selectable  128, 256, 512  or  1024  Byte  Sector  Lengths 
WRITE  MODE 
Single/Multiple  Sector  Write  with  Automatic  Sector 

Search 
Entire  Track  Write  for  Diskette  Formatting 
SYSTEM  COMPATIBILITY 
Double  Buffering  of  Data  8  Bit  Bi-Directional  Bus  for 

Data,  Control  and  Status 
DMA  or  Programmed  Data  Transfers 
All  inputs  and  Outputs  are  TTL  Compatible 
On-Chtp  Track  and  Sector  Registers/Comprehensive 

Status  Information 


PROGRAMMABLE  CONTROLS 

Selectable  Track  to  Track  Stepping  Time 

Side  Select  Compare 

INTERFACES  TO  WD1691  DATA  SEPARATOR 

WINDOW  EXTENSION 

INCORPORATES  ENCODING/DECODING  AND 

ADDRESS  MARK  CIRCUITRY 

FD1792/4  IS  SINGLE  DENSITY  ONLY 

FD1795/7  HAS  A  SIDE  SELECT  OUTPUT 

179X.02  FAMILY  CHARACTERISTICS 


FEATURES 

1791 

1792 

1793 

1794 

1795 

1797 

Single  Density  (FM) 

X 

X 

X 

X 

X 

X 

Double  Density  (MFM) 

X 

X 

X 

X 

True  Data  Bus 

X 

X 

X 

Inverted  Data  Bus 

X 

X 

X 

Write  Precomp 

X 

X 

X 

X 

X 

X 

Side  Selection  Output 

X 

X 

APPLICATIONS 

8"  FLOPPY  AND  5V4  "  MINI  FLOPPY  CONTROLLER 
SINGLE  OR  DOUBLE  DENSITY 
CONTROLLER/  FORMATTER 


NC 

C 

f               ''■— '                40 

3  VDDi»  12V 

we 

C 

2                            39 

3   SNTRQ 

es 

c 

3                            38 

"]  DRO 

RE 

c 

4                              37 

3  ddIn  ,r 

Ao 

c 

5                              36 

^  vvpnr 

At 

cj 

6                              35 

3  p 

"DALO 

c 
c 

r                      3< 

8                              33 

"1  Troo 

DAL  t 

1  WF/VFOE 

DAL  7 

L 

1  READY 

DAL  3 

c 

10 

3! 

1  WD 

6aT* 

c 

30 

3  WC 

DAI,  5 

r 

12 

29 

J  TG43 

PaTB 

L 

t3                    ?e 

"1  HL0 

6aT7 

c 

14                                  21 

"J  RAWREAO 

STEP 

c 

15                            26 

1  RCLK 

01BC  C 

16                            2b 

3   • 

EARLY 

c 

17                              ?4 

3  CLK 

LATE 

c 

18                              23 

~j   HLT 

Mft 

c 

19                             22 

3   TEST 

(GNO|VSS 

c 

20                             21 

J   VCCI'5VJ 

"1791/3  =  RG         1795/7  = 
"1793/7  TRUE  BUS 
M792MOPEN 


PIN  DESIGNATION 


c 

0 
M 

y 

T 
E 

R 

N 
T 
E 
R 
F 
A 
C 
E 

< 

DATA  (8)         ^> 
A0 

USX 

FLOPPY  0ISK 
CONTROLLER 
FORMATTER 

vss    VDD      vcc 

RAW  READ 

RCLK 

t 
O 
P 
P 

O 
! 
S 

K 

N 
T 
E 

a 

F 
A 

c 

e 

RG/SSO 

A1 

LATE 

cs 

EARLY 

_ 

WD 

WE 

*5 

E 

MR 

i- 

■1   " 

K 

10K 

►                  >t0K 

ORO       J 

F7VFO 

WPRT 

^           WG 

Ip 

TROO 

ready 

TG43 

STEP 

4 

tNTRO      J 

DiRC 

CLK 

** 

4BV 

OOEN 

HLD 

ONE  SHOT 
(IFUSEDJ 

HLT 

= 

1    1    1 

T 

+5V 

FD179X  SYSTEM  BLOCK  DIAGRAM 


November,  1982 


PIN  OUTS 


PIN 
NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

1 
19 

NO  CONNECTION 

NC 
MR 

Pin  1  is  internally  connected  to  a  back  bias  generator  and 
must  be  left  open  by  the  user. 

A  logic  low  (50  microseconds  min)  on  this  input  resets  the 
device  and  loads  HEX  03  into  the  command  register.  The  Not 
Ready  (Status  Bit  7)  is  reset  during  MR  ACTIVE  When  MR  is 
brought  to  a  logic  high  a  RESTORE  Command  is  executed, 
regardless  of  the  state  of  the  Ready  signal  from  the  drive. 
Also,  HEX  01  is  loaded  into  sector  register 

MASTER  RESET 

20 

POWER  SUPPLIES 

Vss 

Ground 

21 

Vcc 

+  5V  ±5% 

40 

Vdd 

+  12V  ±5% 

COMPUTE 

2 

3 
4 

R  INTERFACE 

WE 
CS 
RE 

A  logic  iow  on  this  input  gates  data  on  the  DAL  into  the 
selected  register  when  CS  is  low. 

A  logic  iow  on  this  input  selects  the  chip  and  enables 
computer  communication  with  the  device, 

A  iogic  iow  on  this  input  controls  the  placement  of  data  from  a 
selected  register  on  the  DAL  when  CS  is  low. 

WRITE  ENABLE 

CHIP  SELECT 

READ  ENABLE 

5,6 

REGISTER  SELECT  LINES 

A0.A1 

These  inputs  select  the  register  to  receive/transfer  data  on  the 
DAL  lines  under  RE  and  WE  control: 

CS      A1      A0                    RE                        WE 

7-14 

0       0       0              Status  Reg        Command  Reg 
0        0        1               Track  Reg          Track  Reg 
0        1        0              Sector  Reg        Sector  Reg 
0        1        1               Data  Reg           Data  Reg 

Eight  bit  Bidirectional  bus  used  for  transfer  of  data,  control, 
and  status.  This  bus  is  receiver  enabled  by  WE  or  transmitter 
enabled  by  RE  Each  line  will  drive  1  standard  TTL  load 

DATA  ACCESS  LINES 

DAL0-DAL7 

24 

CLOCK 

CLK 

This  input  requires  a  free-running  50%  duty  cycle  square  wave 
clock  for  internal  timing  reference,  2  MHz  ±  1  %  for  8"  drives, 
1  MHz  ±1%  for  mini-floppies. 

38 

DATA  REQUEST 

DRQ 

This   open  drain  output   indicates  that  the   DR  contains 
assembled  data  in  Read  operations,  or  the  DR  is  empty  in 
Write  operations.  This  signal  is  reset  when  serviced  by  the 
computer  through  reading  or  loading  the  DR  in  Read  or  Write 
operations,  respectively  Use  10K  pull-up  resistor  to  +  5. 

39 
FLOPPY  0 

INTERRUPT  REQUEST 
ISK  INTERFACE: 

INTRO 

This  open  drain  output  is  set  at  the  completion  of  any  com- 
mand and  is  reset  when  the  STATUS  register  is  read  or  the 
command  register  is  written  to.  Use  10K  pull-up  resistor  to 
+  5 

15 

STEP 

STEP 

The  step  output  contains  a  pulse  for  each  step. 

16 

DIRECTION 

DIRC 

Direction  Output  is  active  high  when  stepping  in,  active  low 
when  stepping  out 

17 

EARLY 

EARLY 

Indicates  that  the  WRITE  DATA  pulse  occuring  while  Early  is 
active  (high)  should   be  shifted  early  for  write   preconv 
pensation. 

18 

LATE 

LATE 

Indicates  that  the  write  data  pulse  occurring  while  Late  is 
active  (high)  should  be  shifted  late  for  write  precompensation. 

PIN 
NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

22 

TEST 

TEST 

This  input  is  used  for  testing  purposes  only  and  should  be  tied 
to  +  5V  or  left  open  by  the  user  unless  interfacing  to  voice  coil 
actuated  steppers 

23 

HEAD  LOAD  TIMING 

HLT 

When  a  logic  high  is  found  on  the  HLT  input  the  head  is 
assumed  to  be  engaged.  It  is  typically  derived  from  a  1  shot 
triggered  by  HLD,, 

25 

READ  GATE 

RG 

This  output  is  used  for  synchronization  of  externa!  data 

(1791,1792,1793,1794) 

separators  The  output  goes  high  after  two  Bytes  of  zeros  in 
single  density,  or  4  Bytes  of  either  zeros  or  ones  in  double 
density  operation. 

25 

SIDE  SELECT  OUTPUT 

SSO 

The  logic  level  of  the  Side  Select  Output  is  directly  controlled 

(1795,1797) 

by  the 'S'  flag  in  Type  II  or  HI  commands  When  U  =  1,  SSO  is 
set  to  a  logic  1  When  U  =  0,  SSO  is  set  to  a  logic  0  The  SSO 
is  compared  with  the  side  information  in  the  Sector  ID  Field 
If  they  do  not  compare  Status  Bit  4  (RNF)  is  set  The  Side 
Select  Output  is  only  updated  at  the  beginning  of  a  Type  II  or 
ill  command,.  It  is  forced  to  a  logic  0  upon  a  MASTER  RESET 
condition, 

26 

READ  CLOCK 

RCLK 

A  nominal  square-wave  clock  signal  derived  from  the  data 
stream  must  be  provided  to  this  input..  Phasing  (i.e.  RCLK 
transitions)  relative  to  RAW  READ  is  important  but  polarity 

27 

(RCLK  high  or  low)  is  not 

The  data  input  signal  directly  from  the  drive.  This  input  shall 

RAW  READ 

RAW  READ 

be  a  negative  pulse  for  each  recorded  flux  transition 

28 

HEAD  LOAD 

HLD 

The  HLD  output  controls  the  loading  of  the  Read-Write  head 
against  the  media, 

29 

TRACK  GREATER  THAN  43 

TG43 

This  output  informs  the  drive  that  the  Read/Write  head  is 
positioned  between  tracks  44-76  This  output  is  valid  only 
during  Read  and  Write  Commands, 

30 

WRITE  GATE 

WG 

This  output  is  made  valid  before  writing  is  to  be  performed  on 
the  diskette 

31 

WRITE  DATA 

WD 

A  200  ns  (MFM)  or  500  ns  (FM)  output  pulse  per  flux  transition 
WD  contains  the  unique  Address  marks  as  well  as  data  and 
clock  in  both  FM  and  MFM  formats. 

32 

READY 

READY 

This  input  indicates  disk  readiness  and  is  sampled  for  a  logic 
high  before  Read  or  Write  commands  are  performed  if  Ready 
is  low  the  Read  or  Write  operation  is  not  performed  and  an 
interrupt  is  generated.,  Type  I  operations  are  performed 
regardless  of  the  state  of  Ready..  The  Ready  input  appears  in 

33 

inverted  format  as  Status  Register  bit  7 

This  is  a  bi-directional  signal  used  to  signify  writing  faults  at 

WRITE  FAULT 

WF/VFOE 

VFO  ENABLE 

the  drive,  and  to  enable  the  external  PLO  data  separator.  When 
WG  =  1,  Pin  33  functions  as  a  WF  input,  If  WF  =  0,  any  write 
command  will  immediately  be  terminated  When  WG  =  0,  Pin 
33  functions  as  a  VFOE  output.  VFOE  will  go  low  during  a  read 
operation  after  the  head  has  loaded  and  settled  (HLT  ~  1)  On 
the  1795/7,  it  will  remain  low  until  the  last  bit  of  the  second 
CRC  byte  in  the  ID  field  VFOE  will  then  go  high  until  8  bytes 
(MFM)  or  4  bytes  (FM)  before  the  Address  Mark  It  will  then  go 
active  until  the  last  bit  of  the  second  CRC  byte  of  the  Data 
Field  On  the  1791/3,  VFOE  will  remain  tow  until  the  end  of  the 

34 

TR00 

Data  Field  This  pin  has  an  internal  100K  Ohm  pull-up  resistor 
This  input  informs  the  FD179X  that  the  Read/Write  head  is 

TRACK 00 

positioned  over  Track  00 

PIN   NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

35 
36 

37 

IP 
WPRj 

DDEN 

This  input  informs  the  FD179X  when  the  index  hole  is  en- 
countered  on  the  diskette 

This  input  is  sampled  whenever  a  Write  Command  is  received. 
A  logic  Sow  terminates  the  command  and  sets  the  Write 
Protect  Status  bit 

This   input    pin   selects   either   single   or  double   density 
operation.  When  DDEN  =  0,  double  density  is  selected.  When 
DDEN  =  1,  single  density  is  selected,  This  line  must  be  left 
open  on  the  1792/4 

INDEX  PULSE 

WRITE  PROTECT 

DOUBLE  DENSITY 

GENERAL  DESCRIPTION 

The  FD179X  are  N-Channel  Silicon  Gate  MOS  LSI 
devices  which  perform  the  functions  of  a  Floppy  Disk 
Formatter/Controller  in  a  single  chip  implementation. 
The  FD179X,  which  can  be  considered  the  end  result 
of  both  the  FD1771  and  FD1781  designs,  is  IBM  3740 
compatible  in  single  density  mode  (FM)  and  System  34 
compatible     in     Double     Density     Mode    (MFM),     The 


FD1771,  plus  the  added  features  necessary  to 
read/write  and  format  a  double  density  diskette  These 
include  address  mark  detection,  FM  and  MFM  encode 
and  decode  logic,  window  extension,  and  write  precom- 
pensation.  In  order  to  maintain  compatibility,  the 
FD1771,  FD1781,  and  FD179X  designs  were  made  as 
close  as  possible  with  the  computer  interface,  instruc- 
tion set,  and  I/O  registers  being  identical  Also,  head 
load  control  is  identical  in  each  case,  the  actual  pin 
assignments  vary  by  only  a  few  pins  from  any  one  to 
another 

The  processor  interface  consists  of  an  8-bit  bi-direc- 
tional bus  for  data,  status,  and  control  word  transfers. 
The  FD179X  is  set  up  to  operate  on  a  multiplexed  bus 
with  other  bus-oriented  devices 

The  FD179X  is  TTL  compatible  on  all  inputs  and 
outputs  The  outputs  will  drive  ONE  TTL  load  or  three 
LS  loads  The  1793  is  identical  to  the  1791  except  the 
DAL  lines  are  TRUE  for  systems  that  utilize  true  data 


The  1795/7  has  a  side  select  output  for  controlling 
double  sided  drives,  and  the  1792  and  1794  are  "Single 
Density  Only"  versions  of  the  1791  and  1793  respec- 
tively On  these  devices,  DDEN  must  be  left  open,. 

ORGANIZATION 

The  Floppy  Disk  Formatter  block  diagram  is  illustrated 
on  page  5,  The  primary  sections  include  the  parallel 
processor  interface  and  the  Floppy  Disk  interface. 

Data  Shift  Register  —  This  8-bit  register  assembles 
serial  data  from  the  Read  Data  input  (RAW  READ) 
during  Read  operations  and  transfers  serial  data  to  the 
Write  Data  output  during  Write  operations. 
Data  Register  —  This  8-bit  register  is  used  as  a 
holding  register  during  Disk  Read  and  Write  operations. 
In  Disk  Read  operations  the  assembled  data  byte  is 
transferred  in  parallel  to  the  Data  Register  from  the 
Data  Shift  Register,  In  Disk  Write  operations  in- 
formation is  transferred  in  parallel  from  the  Data 
Register  to  the  Data  Shift  Register 


When  executing  the  Seek  command  the  Data  Register 
holds  the  address  of  the  desired  Track  position.  This 
register  is  loaded  from  the  DAL  and  gated  onto  the 
DAL  under  processor  control. 

Track  Register  —  This  8-bit  register  holds  the  track 
number  of  the  current  Read/Write  head  position.  It  is 
incremented  by  one  every  time  the  head  is  stepped  in 
(towards  track  76)  and  decremented  by  one  when  the 
head  ic  ctonncd  out  'towards  track  00V  The  contents  of 
the  register  are  compared  with  the  recorded  track 
number  in  the  ID  field  during  disk  Read,  Write,  and 
Verify  operations.  The  Track  Register  can  be  loaded 
from  or  transferred  to  the  DAL  This  Register  should 
not  be  loaded  when  the  device  is  busy 
Sector  Register  (SR)  —  This  8- bit  register  holds  the  address 
of  the  desired  sector  position.  The  contents  of  the  register 
are  compared  with  the  recorded  sector  number  in  the  ID 
field  during  disk  Read  or  Write  operations.  The  Sector 
Register  contents  can  be  loaded  from  or  transferred  to  the 
DAL  This  register  should  not  be  loaded  when  the  device  is 
busy. 

Command  Register  (CR)  —  This  8-bit  register  holds  the 
command  presently  being  executed.  This  register  should 
not  be  loaded  when  the  device  is  busy  unless  the  new 
command  is  a  force  interrupt  The  command  register  can 
be  loaded  from  the  DAL,  but  not  read  onto  the  DAL 
Status  Register  (STR)  —  This  8-bit  register  holds  device 
Status  information.  The  meaning  of  the  Status  bits  is  a 
function  of  the  type  of  command  previously  executed.  This 
register  can  be  read  onto  the  DAL,  but  not  loaded  from  the 
DAL 

CRC  Logic  —  This  logic  is  used  to  check  or  to  generate  the 
16-bit  Cyclic  Redundancy  Check  (CRC)  The  polynomial  is: 
G(x)  =  x10  +  x"  +  xs  +  1. 

The  CRC  includes  all  information  starting  with  the  address 
mark  and  up  to  the  CRC  characters.  The  CRC  register  is 
preset  to  ones  prior  to  data  being  shifted  through  the 
circuit. 

Arithmetic/Logic  Unit  (ALU)  —  The  ALU  is  a  serial  com- 
parator, incrementer,  and  decrementer  and  is  used  for 
register  modification  and  comparisons  with  the  disk 
recorded  ID  field. 

Timing  and  Control  —  All  computer  and  Floppy  Disk  In- 
terface controls  are  generated  through  this  logic  The  in- 
terna! device  timing  is  generated  from  an  external  crystal 
clock 

The  FD179X  has  two  different  modes  of  operation  ac- 
cording to  the  state  of  DDEN  When  DDEN  =  0  double 
density  (MFM)  is  assumed    When  DDEN    =    1,  single 
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FD179X  BLOCK  DIAGRAM 


density  (FM)  is  assumed  1792  &  1794  are  single  density 
only, 

AM  Detector  —  The  address  mark  detector  detects  ID,  data 
and  index  address  marks  during  read  and  write  operations, 

PROCESSOR  INTERFACE 

The  interface  to  the  processor  is  accompiished  through  the 
eight  Data  Access  Lines  {DAL)  and  associated  control 
signals  The  DAL  are  used  to  transfer  Data,  Status,  and 
Control  words  out  of,  or  into  the  FD179X.  The  DAL  are  three 
state  buffers  that  are  enabied_a_s  output  drivers  when  Chip 
Select  (CS)  and  Read  Enable  (RE)_are  active  (low  logic  state) 
or  act  as  input  receivers  when  CS  and  Write  Enable  (WE) 
are  active, 

When  transfer  of  data  with  the  Floppy  Disk  Controller  is 
required  by  the  host  processor,  the  device  address  is 
decoded  and  CS  is  made  low^The  address  bits  A1  and  AO, 
combined  with  the  signals  RE  during  a  Read  operation  or 
WE  during  a  Write  operation  are  interpreted  as  selecting 
the  following  registers: 


A1  -  AO 


READ  (RE) 


WRITE  (WE) 


0  0  Status  Register  Command  Register 

0  1  Track  Register  Track  Register 

1  0  Sector  Register          Sector  Register 
1  1  Data  Register Data  Register 


During  Direct  Memory  Access  (DMA)  types  of  data 
transfers  between  the  Data  Register  of  the  FD179X  and  the 
processor,  the  Data  Request  (DRQ)  output  is  used  in  Data 
Transfer  control.  This  signal  also  appears  as  status  bit  1 
during  Read  and  Write  operations 

On  Disk  Read  operations  the  Data  Request  is  activated  {set 
high)  when  an  assembled  serial  input  byte  is  transferred  in 
parallel  to  the  Data  Register,  This  bit  is  cleared  when  the 
Data  Register  is  read  by  the  processor,  If  the  Data  Register 
is  read  after  one  or  more  characters  are  lost,  by  having  new 
data  transferred  into  the  register  prior  to  processor  readout, 
the  Lost  Data  bit  is  set  in  the  Status  Register  The  Read 
operation  continues  until  the  end  of  sector  is  reached 
On  Disk  Write  operations  the  data  Request  is  activated 
when  the  Data  Register  transfers  its  contents  to  the  Data 


Shift  Register,  and  requires  a  new  data  byte  It  is  reset 

when  the  Data  Register  is  loaded  with  new  data  by  the 

processor  If  new  data  is  not  loaded  at  the  time  the  next 

serial  byte  is  required  by  the  Floppy  Disk,  a  byte  of  zeroes 

is  written  on  the  diskette  and  the  Lost  Data  bit  is  set  in  the 

Status  Register, 

At   the   completion   of   every   command   an    INTRQ   is 

generated   INTRQ  is  reset  by  either  reading  the  status 

register  or  by  loading  the  command  register  with  a  new 

command   In  addition,  INTRQ  is  generated  if  a  Force 

interrupt  command  condition  is  met. 

The  179X  has  two  modes  of  operation  according  to  the 

state  of  DDEN  {Pin  37)  When  DDEN  =  1,  single  density  is 

selected  in  either  case,  the  CLK  input  (Pin  24)  is  at  2  MHz. 

However,  when  interfacing  with  the  mini-floppy,  the  CLK 

input  is  set  at  1  MHz  for  both  single  density  and  double 

density, 

GENERAL  DISK  READ  OPERATIONS 

Sector  lengths  of  128,  256,  512  or  1024  are  obtainable  in 

either  FM  or  MFM  formats.  For  FM,  DDEN  should  be 

placed  to  logical  "1  "  For  MFM  formats,  DDEN  should  be 

placed  to  a  logical  "0."  Sector  lengths  are  determined  at 

format  time  by  the  fourth  byte  in  the  "ID"  fiekl 


Sector  Length  Table* 


Sector  Length 
Field  (hex) 


Number  of  Bytes 
in  Sector  (decimal) 


00 
01 
02 
03 


128 
256 
512 
1024 


'1795/97  may  vary  —  see  command  summary,. 
The  number  of  sectors  per  track  as  far  as  the  FD179X  is 
concerned  can  be  from  1  to  255  sectors.  The  number  of 
tracks  as  far  as  the  FD179X  is  concerned  Is  from  0  to  255 
tracks  For  IBM  3740  compatibility,  sector  lengths  are  128 
bytes  with  26  sectors  per  track,  For  System  34  com- 
patibility (MFM),  sector  lengths  are  256  bytes/sector  with  26 
sectors/track;  or  lengths  of  1024  bytes/sector  with  8 
sectors/track.  (See  Sector  Length  Table) 
For  read  operations  in  8"  double  density  the  FD179X 
requires  RAW  READ  Data  (Pin  27)  signal  which  is  a  200  ns 
pulse  per  flux  transition  and  a  Read  clock  (RCLK)  signal  to 
indicate  flux  transition  spacings  The  RCLK  (Pin  26)  signal 
is  provided  by  some  drives  but  if  not  it  may  be  derived 
externally  by  Phase  lock  loops,  one  shots,  or  counter 
techniques.  In  addition,  a  Read  Gate  Signal  is  provided  as 
an  output  (Pin  25)  on  1791/92/93/94  which  can  be  used  to 
inform  phase  lock  loops  when  to  acquire  synchronization 
When  reading  from  the  media  in  FM.  RG  is  made  true  when 
2  bytes  of  zeroes  are  detected  The  FD179X  must  find  an 
address  mark  within  the  next  10  bytes;  otherwise  RG  is 
reset  and  the  search  for  2  bytes  of  zeroes  begins  all  over 
again  if  an  address  mark  is  found  within  10  bytes,  RG 
remains  true  as  long  as  the  FD179X  is  deriving  any  useful 
information  from  the  data  stream.  Similarly  for  MFM,  RG  is 
made  active  when  4  bytes  of  "00"  or  "FF"  are  detected.  The 
FD179X  must  find  an  address  mark  within  the  next  16 
bytes,  otherwise  RG  is  reset  and  search  resumes. 
During  read  operations  (WG  =  0),  the  VFOE  (Pin  33)  is 
provided  for  phase  lock  loop  synchronization  VFOE  will  go 
active  low  when: 


a)  Both  HLT  and  HLD  are  True 

b)  Settling  Time,  if  programmed,  has  expired 

c)  The  179X  is  inspecting  data  off  the  disk 

tf  WF/VFOE  is  not  used,  leave  open  or  tie  to  a  10K  resistor 
to  +5. 

GENERAL  DISK  WRITE  OPERATION 
When  writing  is  lo  take  place  on  the  diskette  the  Write  Gate 
(WG)  output  is  activated,  allowing  current  to  flow  into  the 
Read/Write  head  As  a  precaution  to  erroneous  writing  the 
first  data  byte  must  be  loaded  into  the  Data  Register  in 
response  to  a  Data  Request  from  the  FD179X  before  the 
Write  Gate  signal  can  be  activated, 
Writing  is  inhibited  when  the  WriteProtect  input  is  a  logic 
low,  in  which  case  any  Write  command  is  immediately 
terminated,  an  interrupt  is  generated  and  the  Write  Protect 
status  bit  is  set  The  Write  Fault  input,  when  activated, 
signifies  a  writing  fault  condition  detected  in  disk  drive 
electronics  such  as  failure  to  detect  write  current  flow 
when  the  Write  Gate  is  activated  On  detection  of  this  fault 
the  FD179X  terminates  the  current  command,  and  sets  the 
Write  Fault  bit  (bit  5)  in  the  Status  Word.  The  Write  Fault 
input  should  be  made  inactive  when  the  Write  Gate  output 
becomes  inactive 

For  write  operations,  the  FD179X  provides  Write  Gate  (Pin 
30)  and  Write  Data  (Pin  31)  outputs.  Write  data  consists  of  a 
series  of  500  ns  pulses  in  FM  (DDEN  =  1)  and  200  ns 
pulses  in  MFM  (DDEN  =  0).  Write  Data  provides  the  unique 
address  marks  in  both  formats 

Also  during  write,  two  additional  signals  are  provided  for 
write  precompensation  These  are  EARLY  (Pin  17)  and 
LATE  (Pin  18)  EARLY  is  active  true  when  the  WD  pulse 
appearing  on  (Pin  30)  is  to  be  written  EARLY.  LATE  is  active 
true  when  the  WD  pulse  is  to  be  written  LATE.  If  both 
EARLY  and  LATE  are  tow  when  the  WD  pulse  is  present, 
the  WD  pulse  is  to  be  written  at  nominal,  Since  write 
precompensation  values  vary  from  disk  manufacturer  to 
disk  manufacturer,  the  actual  value  is  determined  by 
several  one  shots  or  delay  lines  which  are  located  external 
to  the  FD179X  The  write  precompensation  signals  EARLY 
and  LATE  are  valid  for  the  duration  of  WD  in  both  FM  and 
MFM  formats 

READY 

Whenever  a  Read  or  Write  command  (Type  II  or  III)  is 
received  the  FD179X  samples  the  Ready  input,,  tf  this  input 
is  logic  low  the  command  is  not  executed  and  an  interrupt 
is  generated  All  Type  t  commands  are  performed  re- 
gardless of  the  state  of  the  Ready  input.  Also,  whenever  a 
Type  II  or  til  command  is  received,  the  TG43  signal  output 
is  updated 

COMMAND  DESCRIPTION 

The  FD179X  will  accept  eleven  commands  Command 
words  should  only  be  loaded  in  the  Command  Register 
when  the  Busy  status  bit  is  off  (Status  bit  0).  The  one 
exception  is  the  Force  Interrupt  command  Whenever  a 
command  is  being  executed,  the  Busy  status  bit  is  set. 
When  a  command  is  completed,  an  interrupt  is  generated 
and  the  Busy  status  bit  is  reset.  The  Status  Register 
indicates  whether  the  completed  command  encountered 
an  error  or  was  fault  free  For  ease  of  discussion, 
commands  are  divided  into  four  types  Commands  and 
types  are  summarized  in  Table  1 


A.  Commands  for  Models:  1791, 1792, 1793, 1794 


Restore 

Seek 
I     Step 

Step-in 
I     Step-out 

Read  Sector 

Write  Sector 

III  Read  Address 
Read  Track 

HI    Write  Track 

IV  Force  Interrupt 


TABLE  1.     COMMAND  SUMMARY 


B.  Commands  for  Models:  1795, 1797 


FLAG  SUMMARY 


TABLE  2.  FLAG  SUMMARY 


Command 
Type 


II  &  III 


II  &  III 


Bit 
No{s) 


0-3 


r1  r0  =  Stepping  Motor  Rate 
See  Table  3  for  Rate  Summary 

V  =  Track  Number  Verify  Flag 

h  =  Head  Load  Flag 
T  =  Track  Update  Flag 
a0  =  Data  Address  Mark 
C  =:  Side  Compare  Flag 
U  =  Update  SSO 
E  =  15  MS  Delay 
S  =  Side  Compare  Flag 
L  ~  Sector  Length  Flag 

m  =  Multiple  Record  Flag 


Description 


V  =  0,  No  verify 

V  =  1,  Verify  on  destination  track 

h    =  1,  Load  head  at  beginning 
h   =  0,  Unload  head  at  beginning 

T   =  0f  No  update 

T   :=  1,  Update  track  register 

30=  OfFB(DAM) 

a0  =  1,F8  (deleted  DAM) 

C  =  0,  Disable  side  compare 

C  =  1,  Enable  side  compare 

U  =  0,  Update  SSO  toO 
U  ==  1,  Update  SSO  to  1 


=  0,  No  15  MS  delay 

=  1t15MSdelay 


S   =  0,  Compare  for  side  0 
S   =  1,  Compare  for  side  1 


LSB's  Sector  Length  in  ID  Field 
00              01              10              11 

L   =0 

256             512            1024             128 

L    =  1 

128             256              512           1024 

m  =  0,  Single  record 
m  =  1,  Multiple  records 


!x  ~  Interrupt  Condition  Flags 

f0  =  1  Not  Ready  To  Ready  Transition 

'1  =  1  Ready  To  Not  Ready  Transition 

!2  =  1 1ndex  Pulse 

f3  =  1  Immediate  interrupt,  Requires  A  Reset 


!3-k)     =  Q  Terminate  With  No  interrupt  (INTRQ) 


NOTE:  See  Type  IV  Command  Description  for  further  information 


TYPE  I  COMMANDS 

The  Type  I  Commands  include  the  Restore,  Seek,  Step, 
Step-In,  and  Step-Out  commands    Each  of  the  Type  1 
Commands  contains  a  rate  field  (FQ  M),  which  determines 
the  stepping  motor  rate  as  defined  in  Table  3, 
A  2  jiS  (MFM}  or  4  ms  (FM)  pulse  is  provided  as  an  output  to 
the  drive.  For  every  step  pulse  issued,  the  drive  moves  one 
track  location  in  a  direction  determined  by  the  direction 
output,  The  chip  will  step  the  drive  in  the  same  direction  it 
last  stepped  unless  the  command  changes  the  direction 
The  Direction  signal  is  active  high  when  stepping  in  and 
low  when  stepping  out.  The  Direction  signal  is  valid  12  Hs 
before  the  first  stepping  pulse  is  generated 
The  rates  (shown  in  Table  3)  can  be  applied  to  a  Step- 
Direction  Motor  through  the  device  interlace 
TABLE  3.  STEPPING  RATES 


CLK 

2  MHz 

2  MHz 

1  MHz 

1  MHz 

2  MHz 

1  MHz 

DDEN 

0 

1 

0 

1 

x 

X 

R1  RO 

TEST=1 

TEST=1 

TEST=1 

t"es"t=i 

TEST^O 

TEST=0 

0     0 

3  ms 

3  ms 

6  ms 

6  ms 

184jis 

368ftS 

0     1 

6  ms 

6  ms 

12  ms 

12  ms 

1 90j*s 

380/is 

1     0 

10  ms 

10  ms 

20  ms 

20  ms 

198fiS 

396j<s 

1      1 

15  ms 

15  ms 

30  ms 

30  ms 

208jiS 

A 1 6f»s 

After  the  last  directional  step  an  additional  15  milliseconds 
of  head  settling  time  takes  place  if  the  Verify  flag  is  set  in 
Type  I  commands  Note  that  this  time  doubles  to  30  ms  for 
a  1  MHz  clock,  if  TEST  =  0,  there  is  zero  settling  time. 
There  is  also  a  15  ms  head  settling  time  if  the  E  flag  is  set  in 
anyTypellorll!  command 

When  a  Seek,  Step  or  Restore  command  is  executed  an 
optional  verification  of  Read-Write  head  position  can  be 
performed  by  settling  bit  2  {V  =  1)  in  the  command  word  to 
a  logic  1 .  The  verification  operation  begins  at  the  end  of  the 
15  millisecond  Settling  time  after  the  head  is  loaded  against 
the  media  The  track  number  from  the  first  encountered  ID 
Field  is  compared  against  the  contents  of  the  Track 
Register  If  the  track  numbers  compare  and  the  ID  Field 
Cyclic  Redundancy  Check  (CRC)  is  correct,  the  verify 
operation  is  complete  and  an  tNTRQ  is  generated  with  no 
errors  If  there  is  a  match  but  not  a  valid  CRC,  the  CRC  error 
status  bit  is  set  (Status  bit  3),  and  the  next  encountered  ID 
field  is  read  from  the  disk  for  the  verification  operation. 

The  FD179X  must  find  an  ID  field  with  correct  track  number 
and  correct  CRC  within  5  revolutions  of  the  media; 
otherwise  the  seek  error  is  set  and  an  INTRQ  is  generated 
if  V  =  0,  no  verification  is  performed 

The  Head  Load  (HLD)  output  controls  the  movement  of  the 
read/write  head  against  the  media.  HLD  is  activated  at  the 
beginning  of  a  Type  I  command  if  the  h  flag  is  set  (h  =  1),  at 
the  end  of  the  Type  I  command  if  the  verify  flag  (V  =  1),  or 
upon  receipt  of  any  Type  II  or  111  command  Once  HLD  is 
active  it  remains  active  until  either  a  Type  I  command  is 
received  with  (h  =  0  and  V  =  0);  or  if  the  FD179X  is  in  an 
idle  state  (non-busy)  and  15  index  pulses  have  occurred, 


Head  Load  timing  (HLT)  is  an  input  to  the  FD179X  which  is 
used  for  the  head  engage  time.  When  HLT  =  1,theFD179X 
assumes  the  head  is  completely  engaged  The  head 
engage  time  is  typically  30  to  100  ms  depending  on  drive 
The  low  to  high  transition  on  HLD  is  typically  used  to  fire  a 
one  shot  The  output  of  the  one  shot  is  then  used  for  HLT 
and  supplied  as  an  input  to  the  FD179X. 


MLDf~ 


HLT  (FROM  ONE  SHOT) 


HEAD  LOAD  TIMING 

When  both  HLD  and  HLT  are  true,  the  FD179X  will  then 
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appears  as  status  Bit  5  in  Type  t  status, 

In  summary  for  the  Type  I  commands:  if  h  =  0  and  V  =  0, 
HLD  is  reset  If  h  =  1  and  V  =  0,  HLD  is  set  at  the 
beginning  of  the  command  and  HLT  is  not  sampled  nor  is 
there  an  internal  15  ms  delay  If  h  ~  0  and  V  =  1,  HLD  is 
set  near  the  end  of  the  command,  an  internal  15  ms  occurs, 
and  the  FD179X  waits  for  HLT  to  be  true.  If  h  =  1  and  V  = 
1,  HLD  is  set  at  the  beginning  of  the  command..  Near  the 
end  of  the  command,  after  all  the  steps  have  been  issued, 
an  internal  15  ms  delay  occurs  and  the  FD179X  then  waits 
for  HLT  to  occur 

For  Type  II  and  HI  commands  with  E  flag  off,  HLD  is  made 
active  and  HLT  is  sampled  until  true  With  E  flag  on,  HLD  is 
made  active,  an  internal  15  ms  delay  occurs  and  then  HLT 
is  sampled  until  true 

RESTORE  (SEEK  TRACK  0) 

Upon  receipt  of  this  command  the  Track  00  (TR00)  input  is 
sampled  If  TROO  is  active  low  indicating  the  Read-Write 
head  is  positioned  over  track  0,  the  Track  Register  is  loaded 
with  zeroes  and  an  interrupt  is  generated  if  TROO  is  not 
active  low,  stepping  pulses  (pins  1 5  to  16)  at  a  rate  specified 
by  the  M  r0  field  are  issued  until  the  TROO  input  is  activated 
At  this  time  the  Track  Register  is  loaded  with  zeroes  and  an 
interrupt  is  generated.  If  the  TROO  input  does  not  go  active 
low  after  255  stepping  pulses,  the  FD179X  terminates 
operation,  interrupts,  and  sets  the  Seek  error  status  bit, 
providing  the  V  flag  is  set,.  A  verification  operation  also 
takes  place  if  the  V  flag  is  set,.  The  h  bit  allows  the  head  to 
be  loaded  at  the  start  of  command  Note  that  the  Restore 
command  is  executed  when  MR  goes  from  an  active  to  an 
inactive  state  and  that  the  DRQ  pin  stays  low 

SEEK 

This  command  assumes  that  the  Track  Register  contains 
the  track  number  of  the  current  position  of  the  Read-Write 
head  and  the  Data  Register  contains  the  desired  track 
number  The  FD179X  will  update  the  Track  register  and 
issue  stepping  pulses  in  the  appropriate  direction  until  the 
contents  of  the  Track  register  are  equal  to  the  contents  of 
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TYPE  I  COMMAND  FLOW 

the  Data  Register  (the  desired  track  location).  A  verification 
operation  takes  place  if  the  V  flag  is  on.  The  h  bit  aliows  the 
head  to  be  loaded  at  the  start  of  the  command.,  An  interrupt 
is  generated  at  the  completion  of  the  command  Note: 
When  using  multiple  drives,  the  track  register  must  be 
updated  for  the  drive  selected  before  seeks  are  issued 

STEP 

Upon  receipt  of  this  command,  the  FD179X  issues  one 
stepping  pulse  to  the  disk  drive  The  stepping  motor 
direction  is  the  same  as  in  the  previous  step  command. 
After  a  deiay  determined  by  the  r1r0  field,  a  verification 
takes  place  if  the  V  flag  is  on  If  the  U  flag  is  on,  the  Track 
Register  is  updated.  The  h  bit  allows  the  head  to  be  loaded 
at  the  start  of  the  command  An  interrupt  is  generated  at 
the  completion  of  the  command 

STEP-IN 

Upon  receipt  of  this  command,  the  FD179X  issues  one 
stepping  pulse  in  the  direction  towards  track  76..  If  the  U 
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TYPE  I  COMMAND  FLOW 

flag  is  on,  the  Track  Register  is  incremented  by  one  After  a 
delay  determined  by  the  n^o  field,  a  verification  takes  place 
if  the  V  flag  is  on  The  h  bit  allows  the  head  to  be  loaded  at 
the  start  of  the  command  An  interrupt  is  generated  at  the 
completion  of  the  command. 

STEP-OUT 

Upon  receipt  of  this  command,  the  FD179X  issues  one 
stepping  pulse  in  the  direction  towards  track  0,  If  the  U  flag 
is  on,  the  Track  Register  is  decremented  by  one.  After  a 
deiay  determined  by  the  I'D  field,  a  verification  takes  place 
if  the  V  flag  is  on.  The  h  bit  allows  the  head  to  be  loaded  at 
the  start  of  the  command.  An  interrupt  is  generated  at  the 
completion  of  the  command 

EXCEPTIONS 

On  the  1795/7  devices,  the  SSO  output  is  not  affected 
during  Type  1  commands,  and  an  internal  side  compare 
does  not  take  place  when  the  (V)  Verify  Flag  is  on. 


TYPE  i  COMMAND  FLOW 

TYPE  II  COMMANDS 

The  Type  II  Commands  are  the  Read  Sector  and  Write 
Sector  commands  Prior  to  loading  the  Type  II  Command 
into  the  Command  Register,  the  computer  must  load  the 
Sector  Register  with  the  desired  sector  number  Upon 
receipt  of  the  Type  tl  command,  the  busy  status  Bit  is  set.  If 
the  E  flag  =  1  (this  is  the  normal  case)  HLD  is  made  active 
and  HLT  is  sampled  after  a  15  msec  delay  If  the  E  flag  is  0, 
the  head  is  loaded  and  HLT  sampled  with  no  15  msec 
delay  The  ID  field  and  Data  Field  format  are  shown  on  page 
13. 

When  an  ID  field  is  located  on  the  disk,  the  FD179X 
compares  the  Track  Number  on  the  ID  field  with  the  Track 
Register,  If  there  is  not  a  match,  the  next  encountered  ID 
field  is  read  and  a  comparison  is  again  made,  If  there  was  a 
match,  the  Sector  Number  of  the  ID  field  is  compared  with 
the  Sector  Register  If  there  is  not  a  Sector  match,  the  next 
encountered  ID  field  is  read  off  the  disk  and  comparisons 
again  made  If  the  ID  field  CRC  is  correct,  the  data  field  is 


then  located  and  will  be  either  written  into,  or  read  from 
depending  upon  the  command,  The  FD179X  must  find  an 
ID  field  with  a  Track  number,  Sector  number,  side  number, 
and  CRC  within  four  revolutions  of  the  disk;  otherwise,  the 
Record  not  found  status  bit  is  set  (Status  bit  3)  and  the 
command  is  terminated  with  an  interrupt 
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TYPE  II  COMMAND 

Each  of  the  Type  II  Commands  contains  an  (m)  flag  which 
determines  if  multiple  records  (sectors)  are  to  be  read  or 
written,  depending  upon  the  command.  If  m  =  0,  a  single 
sector  is  read  or  written  and  an  interrupt  is  generated  at  the 
completion  of  the  command  If  m  =  1,  multiple  records  are 
read  or  written  with  the  sector  register  internally  updated 
so  that  an  address  verification  can  occur  on  the  next 
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record  The  FD179X  will  continue  to  read  or  write  multiple 
records  and  update  the  sector  register  in  numerical 
ascending  sequence  until  the  sector  register  exceeds  the 
number  of  sectors  on  the  track  or  until  the  Force  interrupt 
command  is  loaded  into  the  Command  Register,  which 
terminates  the  command  and  generates  an  interrupt, 

For  example:  If  the  FD179X  is  instructed  to  read  sector  27 
and  there  are  only  26  on  the  track,  the  sector  register  ex- 
ceeds the  number  available  The  FD179X  will  search  for  5 
disk  revolutions,  interrupt  out,  reset  busy,  and  set  the 
record  not  found  status  bit 

The  Type  H  commands  for  1791-94  also  contain  side  select 
compare  flags.  When  C  =  0  (Bit  1)  no  side  comparison  is 
made  When  C  =  1,  the  LSB  of  the  side  number  is  read  off 
the  ID  Field  of  the  disk  and  compared  with  the  contents  of 
the  (S)  flag  {Bit  3)  If  the  S  flag  compares  with  the  side 
number  recorded  in  the  ID  field,  the  FD179X  continues  with 
the  ID  search.,  If  a  comparison  is  not  made  within  5  index 
pulses,  the  interrupt  line  is  made  active  and  the  Record- 
NotFound  status  bit  is  set 


N  SECTOR  LENGTH  FIELD 
STORE  LENGTH  IN  INTERNAL 
REGISTER 
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The  Type  II  and  111  commands  for  the  1795-97  contain  a  side 
select  flag  (Bit  1)  When  U  =  0,  SSO  is  updated  to  0. 
Similarly,  U  =  1  updates  SSO  to  t  The  chip  compares  the 
SSO  to  the  ID  field  If  they  do  not  compare  within  5 
revolutions  the  interrupt  line  is  made  active  and  the  RNF 
status  bit  is  set 

The  1795/7  READ  SECTOR  and  WRITE  SECTOR  com- 
mands include  a  'L*  flag.  The  'L*  flag,  in  conjunction  with 
the  sector  length  byte  of  the  ID  Field,  allows  different  byte 
lengths  to  be  implemented  in  each  sector/ For  IBM 
compatability,  the  'L*  flag  should  be  set  to  a  one, 

READ  SECTOR 

Upon  receipt  of  the  Read  Sector  command,  the  head  is 
loaded,  the  Busy  status  bit  set,  and  when  an  ID  field  is 
encountered  that  has  the  correct  track  number,  correct 
sector  number,  correct  side  number,  and  correct  CRC,  the 
data  field  is  presented  to  the  computer.  The  Data  Address 


READ  SECTOR 
SEQUENCE 


0 


READ  BY       ^S— !_*. 

SET  DAT* 
LOST 

COMPUTER   jT 

U" 

(INTRO   RESET  fitiSV  \ 


TYPE  II  COMMAND 


TYPE  II  COMMAND 


WRtTE  SECTOR 
SEQUENCE 


STATUS 
BITS 


TYPE  It  COMMAND 

Mark  of  the  data  field  must  be  found  within  30  bytes  in 
single  density  and  43  bytes  in  double  density  of  the  last  ID 
field  CRC  byte;  if  not,  the  ID  field  is  searched  for  and 
verified  again  followed  by  the  Data  Address  Mark  search,  if 
after  5  revolutions  the  DAM  cannot  be  found,  the  Record 
Not  Found  status  bit  is  set  and  the  operation  is  terminated 
When  the  first  character  or  byte  of  the  data  field  has  been 
shifted  through  the  DSR,  it  is  transferred  to  the  DR,  and 
DRQ  is  generated  When  the  next  byte  is  accumulated  in 
the  DSR,  it  is  transferred  to  the  DR  and  another  DRQ  is 
generated  If  the  Computer  has  not  read  the  previous 
contents  of  the  DR  before  a  new  character  is  transferred 
that  character  is  lost  and  the  Lost  Data  Status  bit  is  set 
This  sequence  continues  until  the  complete  data  field  has 
been  inputted  to  the  computer  If  there  is  a  CRC  error  at  the 
end  of  the  data  field,  the  CRC  error  status  bit  is  set,  and  the 
command  is  terminated  (even  if  it  is  a  multiple  record 
command) 

At  the  end  of  the  Read  operation,  the  type  of  Data  Address 
Mark  encountered  in  the  data  field  is  recorded  in  the  Status 
Register  (Bit  5)  as  shown: 


1  Deleted  Data  Mark 

0  Data  Mark 

WRITE  SECTOR 

Upon  receipt  of  the  Write  Sector  command,  the  head  is 
loaded  (HLD  active)  and  the  Busy  status  bit  is  set,.  When  an 
ID  field  is  encountered  that  has  the  correct  track  number, 
correct  sector  number,  correct  side  number,  and  correct 
CRC,  a  DRQ  is  generated.  The  FD179X  counts  off  11  bytes 
in  single  density  and  22  bytes  in  double  density  from  the 
CRC  field  and  the  Write  Gate  (WG)  output  is  made  active  if 
the  DRQ  is  serviced  (i.e.,  the  DR  has  been  loaded  by  the 
computer).  If  DRQ  has  not  been  serviced,  the  command  is 
terminated  and  the  Lost  Data  status  bit  is  set,.  If  the  DRQ 
has  been  serviced,  the  WG  is  made  active  and  six  bytes  of 
zeroes  in  single  density  and  12  bytes  in  double  density  are 
then  written  on  the  disk.  At  this  time  the  Data  Address 
Mark  is  then  written  on  the  disk  as  determined  by  the  a0 
field  of  the  command  as  shown  below: 


ao 


Data  Address  Mark  (Bit  0) 


Deleted  Data  Mark 
Data  Mark 


The  FD179X  then  writes  the  data  field  and  generates  DRQ's 
to  the  computer  If  the  DRQ  is  not  serviced  in  time  for 
continuous  writing  the  Lost  Data  Status  Bit  is  set  and  a 
byte  of  zeroes  is  written  on  the  disk  The  command  is  not 
terminated.  After  the  last  data  byte  has  been  written  on  the 
disk,  the  two-byte  CRC  is  computed  internally  and  written 
on  the  disk  followed  by  one  byte  of  logic  ones  in  FM  or  in 
MFM,  The  WG  output  is  then  deactivated  For  a  2  MHz 
clock  the  INTRQ  wilt  set  8  to  12^sec  after  the  last  CRC  byte 
is  written.  For  partial  sector  writing,  the  proper  method  is  to 
write  the  data  and  fill  the  balance  with  zeroes,  By  letting  the 
chip  fill  the  zeroes,  errors  may  be  masked  by  the  lost  data 
status  and  improper  CRC  Bytes. 

TYPE  III  COMMANDS 

READ  ADDRESS 

Upon  receipt  of  the  Read  Address  command,  the  head 
is  loaded  and  the  Busy  Status  Bit  is  set  The  next 
encountered  ID  field  is  then  read  in  from  the  disk,  and 
the  six  data  bytes  of  the  ID  field  are  assembled  and 
transferred  to  the  DR,  and  a  DRQ  is  generated  for  each 
byte.  The  six  bytes  of  the  ID  field  are  shown  below: 


TRACK 
ADDR 

SIDE 

NUMBER 

SECTOR 
ADDRESS 

SECTOR 
LENGTH 

CRC 

1 

CRC 
2 

1 

2 

3 

4 

5 

6 

Although  the  CRC  characters  are  transferred  to  the 
computer,  the  FD179X  checks  for  validity  and  the  CRC 
error  status  bit  is  set  if  there  is  a  CRC  error  The  Track 
Address  of  the  ID  field  is  written  into  the  sector 
register  so  that  a  comparison  can  be  made  by  the 
user.  At  the  end  of  the  operation  an  interrupt  is 
generated  and  the  Busy  Status  is  reset 
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READ  TRACK 

Upon  receipt  of  the  READ  track  command,  the  head  is 
loaded,  and  the  Busy  Status  bit  is  set  Reading  starts  with 
the  leading  edge  of  the  first  encountered  index  pulse  and 
continues  until  the  next  index  pulse  AH  Gap,  Header,  and 
data  bytes  are  assembled  and  transferred  to  the  data 
register  and  DRQ's  are  generated  for  each  byte  The  ac- 
cumulation of  bytes  is  synchronized  to  each  address  mark 
encountered  An  interrupt  is  generated  at  the  completion  of 
the  command 

This  command  has  several  characteristics  which  make  it 
suitable  for  diagnostic  purposes  They  are:  the  Read  Gate 


is  not  activated  during  the  command;  no  CRC  checking  is 
performed;  gap  information  is  included  in  the  data  stream; 
the  internal  side  compare  is  not  performed;  and  the  ad- 
dress  mark  detector  is  on  for  the  duration  of  the  command 
Because  the  A.M.  detector  is  always  on,  write  splices  or 
noise  may  cause  the  chip  to  look  for  an  AM  If  an  address 
mark  does  not  appear  on  schedule  the  Lost  Data  status  flag 
is  set 

The  ID  AM,  ID  field,  ID  CRC  bytes,  DAM,  Data,  and  Data 
CRC  Bytes  for  each  sector  will  be  correct  The  Gap  Bytes 
may  be  read  incorrectly  during  write-spiice  time  because  of 
synchronization 


TYPE  III  COMMAND  WRITE  TRACK 


TYPE  HI  COMMAND  WRITE  TRACK 
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CONTROL  BYTES  FOR  INITIALIZATION 


DATA  PATTERN 

FD179X  INTERPRETATION 

FD1791/3  INTERPRETATION 

IN  DR  (HEX) 

IN  FM  (DDEN  =  1) 

IN  MFM  (DDEN  «  0) 

00  thru  F4 

Write  00  thru  F4  with  CLK  -  FF 

Write  00  thru  F4,  in  MFM 

F5 

Not  Allowed 

Write  A1  *  in  MFM,  Preset  CRC 

F6 

Not  Allowed 

Write  C2**  in  MFM 

F7 

Generate  2  CRC  bytes 

Generate  2  CRC  bytes 

F8  thru  FB 

Write  F8  thru  FB,  Clk  -  C7t  Preset  CRC 

Write  F8  thru  FB,  in  MFM 

FC 

Write  FC  with  Clk  =  D7 

Write  FC  in  MFM 

FD 

Write  FD  with  Clk  =  FF 

Write  FD  in  MFM 

FE 

Write  FE,  C!k  =  C7,  Preset  CRC 

Write  FE  in  MFM 

FF 

Write  FF  with  Clk  =  FF 

Write  FF  in  MFM 

•Missing  clock  transition  between  bits  4  and  5 


**  Missing  dock  transition  between  bits  3  &  4 


WRITE  TRACK  FORMATTING  THE  DISK 

(Refer  to  section  on  Type  til  commands  for  flow  diagrams) 

Formatting  the  disk  is  a  relatively  simple  task  when 
operating  programmed  I/O  or  when  operating  under  DMA 
with  a  large  amount  of  memory  Data  and  gap  information 
must  be  provided  at  the  computer  interlace  Formatting  the 
disk  is  accomplished  by  positioning  the  R/W  head  over  the 
desired  track  number  and  issuing  the  Write  Track  com* 
mand. 

Upon  receipt  of  the  Write  Track  command,  the  head  is 
loaded  and  the  Busy  Status  bit  is  set,  Writing  starts  with 
the  leading  edge  of  the  first  encountered  index  pulse  and 
continues  until  the  next  index  pulse,  at  which  time  the 
interrupt  is  activated  The  Data  Request  is  activated  im- 
mediately upon  receiving  the  command,  but  writing  will  not 
start  until  after  the  first  byte  has  been  loaded  into  the  Data 
Register  If  the  DR  has  not  been  loaded  by  the  time  the 
index  pulse  is  encountered  the  operation  is  terminated 
making  the  device  Not  Busy,  the  Lost  Data  Status  Bit  is  set, 
and  the  Interrupt  is  activated  If  a  byte  is  not  present  in  the 
DR  when  needed,  a  byte  of  zeroes  is  substituted 

This  sequence  continues  from  one  index  mark  to  the  next 
index  mark.  Normally,  whatever  data  pattern  appears  in  the 
data  register  is  written  on  the  disk  with  a  normal  clock 
pattern.  However,  if  the  FD179X  detects  a  data  pattern  of 
F5  thru  FE  in  the  data  register,  this  is  interpreted  as  data 
address  marks  with  missing  clocks  or  CRC  generation 

The  CRC  generator  is  initialized  when  any  data  byte  from 
F8  to  FE  is  about  to  be  transferred  from  the  DR  to  the  DSR 
in  FM  or  by  receipt  of  F5  in  MFM.  An  F7  pattern  will 
generate  two  CRC  characters  in  FM  or  MFM,  As  a  con- 
sequence, the  patterns  F5  thru  FE  must  not  appear  in  the 
gaps,  data  fields,  or  ID  fields  Also,  CRC's  must  be 
generated  by  an  F7  pattern 

Disks  may  be  formatted  in  IBM  3740  or  System  34  formats 
with  sector  lengths  of  128, 256, 512,  or  1024  bytes 


TYPE  IV  COMMANDS 

The  Forced  Interrupt  command  is  generally  used  to  ter- 
minate a  multiple  sector  read  or  write  command  or  to  in- 


sure Type  I  status  in  the  status  register.  This  command  can 
be  loaded  into  the  command  register  at  any  time,  if  there  is 
a  current  command  under  execution  (busy  status  bit  set) 
the  command  will  be  terminated  and  the  busy  status  bit 
reset 

The  lower  four  bits  of  the  command  determine  the  con- 
ditional interrupt  as  follows: 

'0  =  Not-Ready  to  Ready  Transition 

H  =  Ready  to  Not-Ready  Transition 
!2  =  Every  index  Pulse 
'3  =  Immediate  Interrupt 

The  conditional  interrupt  is  enabled  when  the  cor- 
responding bit  positions  of  the  command  (!3  -  '0)  are  set  to 
a  1.  Then,  when  the  condition  for  interrupt  is  met,  the  IN- 
TRO line  will  go  high  signifying  that  the  condition  specified 
has  occurred  If  *3  -  !0  are  all  set  to  zero  (HEX  DO),  no  in- 
terrupt will  occur  but  any  command  presently  under 
execution  will  be  immediately  terminated  When  using  the 
immediate  interrupt  condition  (!3  =  1)  an  interrupt  will  be 
immediately  generated  and  the  current  command  ter- 
minated. Reading  the  status  or  writing  to  the  command 
register  will  not  automatically  clear  the  interrupt,  The  HEX 
DO  is  the  only  command  that  will  enable  the  immediate 
interrupt  (HEX  D8)  to  clear  on  a  subsequent  load  command 
register  or  read  status  register  operation  Follow  a  HEX  D8 
with  DO  command 

Wait  8  micro  sec  (double  density)  or  16  micro  sec  (single 
density  before  issuing  a  new  command  after  issuing  a 
forced  interrupt  (times  double  when  clock  =  1  MHz) 
Loading  a  new  command  sooner  than  this  will  nullify  the 
forced  interrupt 

Forced  interrupt  stops  any  command  at  the  end  of  an  in- 
ternal micro-instruction  and  generates  INTRQ  when  the 
specified  condition  is  met..  Forced  interrupt  will  wait  until 
ALU  operations  in  progress  are  complete  (CRC 
calculations,  compares,  etc ) 

More  than  one  condition  may  be  set  at  a  time  if  for 
example,  the  READY  TO  NOT-READY  condition  (H  =  1) 
and  the  Every  Index  Pulse  (*2  =  1)  are  both  set,  the 
resultant  command  would  be  HEX  "DA".  The  "OR"  func- 
tion is  performed  so  that  either  a  READY  TO  NOT-  READY 
or  the  next  Index  Pulse  will  cause  an  interrupt  condition. 
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I  ENTER         J 


SET  BUSY 
RESET  STATUS 

errs  2  a  5 


OELAV  )5MS" 


J 


READ TRACK 
SEQUENCE 


.J  SET  [NTRO  \ 

*"\  RESET  BUSV  J 


"II  TEST- $  NO  DELAY 
II  TEST=- 1  and  CLK  =  1  MHZ  30  MS  DELAY 


TYPE  HI  COMMAND 

Read  Track/Address 
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READ  ADDRESS 
SEQUENCE 


RESET  BUSY 
SET  INTRO 
SET  HNF 


J 


TRANSFER  TRACK 

NUMBER  TO  SECTOR 

R6GISTOR 


c 


J 


TYPE  III  COMMAND 

Read  Track/Address 


STATUS  REGISTER 

Upon  receipt  of  any  command,  except  the  Force  Interrupt 
command,  the  Busy  Status  bit  is  set  and  the  rest  of  the 
status  bits  are  updated  or  cleared  for  the  new  command  If 
the  Force  Interrupt  Command  is  received  when  there  is  a 
current  command  under  execution,  the  Busy  status  bit  is 
reset,  and  the  rest  of  the  status  bits  are  unchanged,.  If  the 
Force  Interrupt  command  is  received  when  there  is  not  a 
current  command  under  execution,  the  Busy  Status  bit  is 
reset  and  the  rest  of  the  status  bits  are  updated  or  cleared 
In  this  case,  Status  reflects  the  Type  1  commands 

The  user  has  the  option  of  reading  the  status  register 
through  program  control  or  using  the  DRQ  line  with  DMA  or 
interrupt  methods  When  the  Data  register  is  read  the  DRQ 
bit  in  the  status  register  and  the  DRQ  line  are  automatically 
reset,  A  write  to  the  Data  register  also  causes  both  DRQ's 
to  reset 

The  busy  bit  in  the  status  may  be  monitored  with  a  user 
program  to  determine  when  a  command  is  complete,  in 

jittU  Ol  UtitMy  litis  iNTRG  line.  When  uaifiy  this  Imt  tv^,  aOUSy 

status  check  is  not  recommended  because  a  read  of  the 
status  register  to  determine  the  condition  of  busy  will  reset 
the  INTRQ  line 


The  format  of  the  Status  Register  is  shown  below: 


(BITS) 

7 

6 

5 

4 

3 

2 

1 

0 

S7 

S6 

S5 

S4 

S3 

S2 

S1 

so 

Status  varies  according  to  the  type  of  command  executed 

as  shown  in  Table  4 

Because  of  interna!  sync  cycles,  certain  time  delays  must 
be  observed  when  operating  under  programmed  I/O..  They 
are:  (times  double  when  clock  -  1  MHz) 


Operation 

Next  Operation 

Delay  Req'd 

FM        |      MFM 

Write  to 
Command  Reg. 

Read  Busy  Bit 
(Status  Bit  0) 

12  (is      |      6ps 

Write  to 
Command  Reg. 

Read  Status 
Bits  1-7 

28  ms      !      14  (is 

Write  Any 
Register 

Read  From  Diff 
Register 

0                  0 

IBM  3740  FORMAT  -  128  BYTES/ SECTOR 

Shown  below  is  the  IBM  single-density  format  with  128 
bytes/sector  In  order  to  format  a  diskette,  the  user  must 
issue  the  Write  Track  command,  and  load  the  data  register 
with  the  following  values.  For  every  byte  to  be  written,  there 
Is  one  Data  Request 
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IBM  3740  FORMAT  —  128  BYTES/SECTOR 

Shown  below  is  the  IBM  single-density  format  with  128 
bytes/sector  In  order  to  format  a  diskette,  the  user  must 
issue  the  Write  Track  command,  and  load  the  data  register 
with  the  foilowing  values.  For  every  byte  to  be  written,  there 
is  one  Data  Request 


IBM  SYSTEM  34  FORMAT-  256  BYTES/SECTOR 

Shown  below  is  the  IBM  dual-density  format  with  256 
bytes/sector.  In  order  to  format  a  diskette  the  user  must 
issue  the  Write  Track  command  and  load  the  data  register 
with  the  following  values  For  every  byte  to  be  written,  there 
is  one  data  request 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

40 

FF{pr00)' 

6 

00 

1 

FC  (Index  Mark) 

26 

FF(orOO)' 
00 

6 

1 

FE  (ID  Address  Mark) 

1 

Track  Number 

1 

Side  Number (00  or 01) 

1 

Sector  Number(1  thru  1  A) 

1 

00  (Sector  Length) 

1 

F7  (2  CRC's  written) 

11 

FF(orOO)' 

6 
1 

00 

FB  (Data  Address  Mark) 

128 
1 

Data  (IBM  uses  E5) 
F7  (2  CRC's  written) 

27 

FF(orOO)' 
FF(or00)1 

247** 

*Write  bracketed  field  26  times 
"Continue  writing  until  FD179X  interrupts  out. 
Approx  247  bytes 

1-Optional  '00'  on  1795/7  only 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

80 

4E 

12 

00 

3 

F6  (Writes  C2) 

1 

FC  (Index  Mark) 

*   50 

4E 
00 

12 

3 

F5  (Writes  A1) 

1 

FE  (ID  Address  Mark) 

1 

Track  Number (0  thru  4C) 

1 

Side  Number  (0or1) 

1 

Sector  Number  (1  thru  1  A) 

1 

01  (Sector  Length) 

1 

F7  (2  CRCs  written) 

22 

4E 

12 

00 

3 

F5  (Writes  A1) 

1 

FB  (Data  Address  Mark) 

256 

DATA 

1 

F7  (2  CRCs  written) 

54 

4E 
4E 

598** 

'Write  bracketed  field  26  times 
"Continue  writing  until  FD179X  interrupts  out. 
Approx  598  bytes 
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1.  NON-IBM  FORMATS 

Variations  in  the  IBM  formats  are  possible  to  a  limited 
extent  if  the  following  requirements  are  met: 

1)  Sector  size  must  be  128, 256, 512  or  1024  bytes 

2)  Gap  2  cannot  be  varied  from  the  IBM  format, 

3)  3  bytes  of  A1  must  be  used  in  MFM, 

!n  addition,  the  Index  Address  Mark  is  not  required  for 
operation  by  the  FD179X  Gap  1 , 3,  and  4  lengths  can  be  as 
short  as  2  bytes  for  FD179X  operation,  however  PLL  lock  up 
time,  motor  speed  variation,  write-splice  area,  etc.  wilt  add 
more  bytes  to  each  gap  to  achieve  proper  operation  It  is 
recommended  that  the  IBM  format  be  used  for  highest 
system  reliability 


FM 

MFM 

Gap! 

16  bytes  FF 

32  bytes  4E 

Gap  I! 

11  bytes  FF 

22  bytes  4E 

* 

6  bytes  00 

12  bytes  00 
3  bytes  A1 

Gap  III"" 

10  bytes  FF 
4  bytes  00 

24  bytes  4E 
8  bytes  00 
3  bytes  A1 

GapiV 

16  bytes  FF 

16  bytes  4E 

"Byte  counts  must  be  exact 

*Byte  counts  are  minimum,  except  exactly  3  bytes  of  A1 
must  be  written 
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READ  ENABLE  TIMING 


TIMING  CHARACTERISTICS 

Ta  =  0°C  to  70°C,  Vdd  =  +  12V  ± 


6V,  Vss  =  0V,  Vcc  =  +5V  ±    25V 


READ  ENABLE  TIMING   (See  Note  6,  Page  21) 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TSET 

Setup  ADDR  &  CS  to  RE 

50 

nsec 

THLD 

Hold  ADDR  &  CS  from  RE 

10 

nsec 

TRE 

RE  Pulse  Width 

400 

nsec 

Ct  =  50  pf 

TDRR 

DRQ  Reset  from  RE 

400 

500 

nsec 

TIRR 

INTRQ  Reset  from  RE 

500 

3000 

nsec 

See  Note  5 

TDACC 

Data  Access  from  RE 

350 

nsec 

Cl  =  50  pf 

TDOH 

Data  Hold  From  RE 

50 

150 

nsec 

Ct  =  50  pf 

WRITE  ENABLE  TIMING   {See  Note  6,  Page  21) 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TSET 

Setup  ADDR  &  CS  to  WE 

50 

nsec 

THLD 

Hold  ADDR  &  CS  from  WE 

10 

nsec 

TWE 

WE  Pulse  Width 

350 

nsec 

TDRR 

DRQ  Reset  from  WE 

400 

500 

nsec 

TIRR 

INTRQ  Reset  from  WE 

500 

3000 

nsec 

See  Note  5 

TDS 

Data  Setup  to  WE 

250 

nsec 

TDH 

Data  Hold  from  WE 

70 

nsec 
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NOMINAL 

DISKETTE 

MODE 

DDEN 

CLK 

T. 

Th 

T, 

8" 

MFM 

0 

2  MHz 

1  jiS 

1  juS 

2  ^s 

8" 

FM 

1 

2  MHz 

2  us 

2jis 

4  jjS 

5" 

MFM 

0 

1  MHz 

2^s 

2jus 

4  ^s 

5,f 

FM 

1 

1  MHz 

4  fis 

4  /js 

8  jis 

INPUT  DATA  TIMING 


WRITE  ENABLE  TIMING 
INPUT  DATA  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

Tpw 
tbc 
Tc 
Tx» 

TX2 

Raw  Read  Pulse  Width 

100 

1500 

1500 

40 

40 

200 
2000 
2000 

nsec 
nsec 
nsec 

nsec 
nsec 

See  Note  1 
1800  ns@70°C 
1800  ns@70°C 
See  Note  1 
See  Note  1 

Raw  Read  Cycle  Time 
RCLK  Cycle  Time 

RCLK  hold  to  Raw  Read 

Raw  Read  hold  to  RCLK 

WRITE  DATA  TIMING:  (ALL  TIMES  DOUBLE  WHEN  CLK  =  1  MHz) 

(See  Note  6,  Page  21) 

SYMBOL 

CHARACTERISTICS 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

Twp 

Write  Data  Pulse  Width 

500 

650 

nsec 

FM 

Twg 

Write  Gate  to  Write  Data 

200 
2 

350 

nsec 
Msec 

MFM 
FM 

Tbc 
Ts 
Th 

Write  data  cycle  Time 
Early  (Late)  to  Write  Data 
Early  (Late)  From 
Write  Data 

125 
125 

1 
2,3,  or  4 

Msec 
jisec 
nsec 
nsec 

MFM 

± CLK  Error 

MFM 

MFM 

Twf 

Write  Gate  off  from  WD 

2 

1 

/xsec 
ixsec 

FM 
MFM 

Twdl 

WD  Valid  to  Clk 

100 

nsec 

CLK-1  MHZ 

Twd2 

WD  Valid  after  CLK 

50 
100 
30 

nsec 
nsec 
nsec 

CLK -2  MHZ 
CLK  =  1  MHZ 
CLK=2  MHZ 
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CLK         

<2MH2>                  j 
DDEN  =  1             [ 

>j 

L 

V/////A 

3 

V/////>. 

CLK         

(2MHZ)                  1 

Twdl   ) 

L Twd2 

«— I 

^          i„          -  p 

'i 

i 

i 

i 

W//A    \ 

V/////A 

WO   MUST   HAVE   RISING   EDGE    IN 
EDGE  IN  SECONO  SHADED  AHEA 

Twdl  *J 

FIRST   SHADED   AREA   AND   TRAILING 

WRITE  DATA/CLOCK  RELATIONSHIP 

L$ Twd2 

WRITE  DATA  TIMING 


MISCELLANEOUS  TIMING:  (Times  Double  When  Clock  -  1  MH4     (See  Note  6,  Page  21) 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TCD. 

Clock  Duty  (low) 

230 

250 

20000 

nsec 

TCD2 

Clock  Duty  (high) 

200 

250 

20000 

nsec 

TSTP 

Step  Pulse  Output 

2  or  4 

^tsec 

See  Note  5 

TDIR 

Dir  Setup  to  Step 

12 

/zsec 

±  CLK  ERROR 

TMR 

Master  Reset  Pulse  Width 

50 

/zsec 

TIP 

Index  Pulse  Width 

10 

^sec 

See  Note  5 

TWF 

Write  Fault  Pulse  Width 

10 

/zsec 
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MISCELLANEOUS  TIMING 

'FROM  STEP  RATE  TABLE 


NOTES: 

1  Pulse  width  on  RAW  READ  (Pin  27)  is  normally 
100-300  ns  However,  pulse  may  be  any  width  if 
pulse  is  entirely  within  window  If  pulse  occurs  in  both 
windows,  then  pulse  width  must  be  less  than  300  ns 
for  MFM  at  CLK  =  2  MHz  and  600  ns  for  FM  at  2 
MHz,,  Times  double  for  1  MHz 

2  A  PPL  Data  Separator  Is  recommended  for  8"  MFM„ 

3  tbc  should  be  2  fis,  nominal  in  MFM  and  4  ps  nominal 
in  FM  Times  double  when  CLK  =  1  MHz. 

4  RCLK  may  be  high  or  low  during  RAW  READ  (Polarity 
is  unimportant) 

5  Times  double  when  clock  =  1  MHz 

6.  Output  timing  readings  are  at  Vol  =  0„8v  and  Voh  = 
2,0v 


Table  A.  STATUS  REGISTER  SUMMARY 

BIT 

ALL  TYPE  1 
COMMANDS 

READ 
ADDRESS 

READ 
SECTOR 

READ 
TRACK 

WRITE 
SECTOR 

WRITE 
TRACK 

S7 
S6 

S5 
S4 
S3 
S2 
S1 
SO 

NOT  READY 
WRITE 
PROTECT 
HEAD  LOADED 
SEEK  ERROR 
CRC  ERROR 
TRACK  0 
INDEX  PULSE 
BUSY 

NOT  READY 
0 

0 
RNF 

CRC  ERROR 
LOST  DATA 
DRQ 
BUSY 

NOT  READY 
0 

RECORD  TYPE 

RNF 

CRC  ERROR 

LOST  DATA 

DRQ 

BUSY 

NOT  READY 
0 

0 

0 

0 
LOST  DATA 
DRQ 
BUSY 

NOT  READY 

WRITE 

PROTECT 

WRITE  FAULT 

RNF 

CRC  ERROR 

LOST  DATA 

DRQ 

BUSY 

NOT  READY 
WRITE 
PROTECT 
WRITE  FAULT 

0 

0 
LOST  DATA 
DRQ 
BUSY 

STATUS  FOR  TYPE  I  COMMANDS 


BIT  NAME 


S7  NOT  READY 


S6  PROTECTED 


S5  HEAD  LOADED 


S4  SEEK  ERROR 


S3  CRC  ERROR 


S2  TRACK  00 


St  INDEX 


SO  BUSY 


MEANING 


This  bit  when  set  indicates  the  drive  is  not  ready  When  reset  it  indicates  that  the  drive 
is  ready  This  bit  is  an  inverted  copy  of  the  Ready  input  and  logically  'ored'  with  MR. 


When  set,  indicates  Write  Protect  is  activated    This  bit  is  an  inverted  copy  of  WRPT 
input, 


When  set,  it  indicates  the  head  is  loaded  and  engaged   This  bit  is  a  loqicai  "and"  of 
HLD  and  HLT  signals 


When  set,  the  desired  track  was  not  verified.  This  bit  is  reset  to  0  when  updated 


CRC  encountered  in  ID  field. 


When  set,  indicates  Read/Write  head  is  positioned  to  Track  0  This  bit  is  an  inverted 
copy  of  the  TROO  input 


When  set,  indicates  index  mark  detected  from  drive  This  bit  is  an  inverted  copv  of  the 
IP  input  V1 


When  set  command  is  in  progress  When  reset  no  command  is  in  progress 
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STATUS   FOR  TYPE  II  AND  HI  COMMANDS 


BIT  NAME 


S7  NOT  READY 


S6  WRITE  PROTECT 


S5  RECORD  TYPE/ 
WRITE  FAULT 


S4  RECORD  NOT 
FOUND  (RNF) 


S3  CRC  ERROR 


S2  LOST  DATA 


MEANING 


This  bit  when  set  indicates  the  drive  is  not  ready  When  reset,  it  indicates  that  the  drive 
is  ready.  This  bit  is  an  inverted  copy  of  the  Ready  input  and  'ored'  with  MR  The  Type  II 
and  ill  Commands  will  not  execute  unless  the  drive  is  ready. 


On  Read  Record:  Not  Used   On  Read  Track:  Not  Used   On  any  Write:  It  indicates  a 
Write  Protect.  This  bit  is  reset  when  updated. 


On  Read  Record:  It  indicates  the  record-type  code  from  data  field  address  mark,, 
1  =  Deleted  Data  Mark,  0  =  Data  Mark  On  any  Write:  It  indicates  a  Write  Fault  This  bit 
is  reset  when  updated. 


When  set,  it  indicates  that  the  desired  track,  sector,  or  side  were  not  found  This  bit  is 
reset  when  updated.    ___ 


If  S4  is  set,  an  error  is  found  in  one  or  more  ID  fields;  otherwise  it  indicates  error  in 
data  field.  This  bit  is  reset  when  updated. 


S1  DATA  REQUEST 


SO  BUSY 


When  set,  it  indicates  the  computer  did  not  respond  to  DRQ  in  one  byte  time  This  bit  is 
reset  to  zero  when  updated. 


This  bit  is  a  copy  of  the  DRQ  output   When  set,  it  indicates  the  DR  is  full  on [j^Re^d 
Operation  or  the  DR  is  ernpiy  on  a  Write  upci   "       ""'"'"  '" l  l  '"  """"  '" 

dated. 


When  set,  command  is  under  execution  When  reset,  no  command  is  under  execution 


ELECTRICAL  CHARACTERISTICS 

Absolute  Maximum  Ratings 
Vdd  with  repect  to  Vss  (ground):  + 15  to  -0.3V 
Voltage  to  any  input  with  respect  to  Vss  =  +  15to  -0,3V 
Ice  =  60  MA  (35  MA  nominal) 
Idd  =  15  MA  (10  MA  nominal) 


Cm  &  Cour  =  15  pF  max  with  ai!  pins  grounded  except 

one  under  test 
Operating  temperature  =  0°Cto70°C 
Storage  temperature  =  -  55° C  to  +  125°C 


OPERATING  CHARACTERISTICS  (DC) 

TA  =  0°Cto70°C,VDD  =  +  12V  ±  6V,  Vss  =  OV,  Vcc  =  +  5V  ±  ,25V 


SYMBOL 

CHARACTERISTIC 

MIN. 

MAX, 

UNITS 

CONDITIONS 

in 

Input  Leakage 

10 

MA 

Vin  —  Vdd" 

!0L 

Output  Leakage 

10 

MA 

Vout  -  Vdd 

VlH 

Input  High  Voltage 

2.6 

V 

Vh. 

Input  Low  Voltage 

0.8 

V 

VOH 

Vol 

Output  High  Voltage 
Output  Low  Voltage 

2.8 

0  45 

V 
V 

lo  -  -  100  fiA 
lo  =  16  mA* 

Pd 

Power  Dissipation 

0.6 

w 

-LeaL^conditions^for  input  pins  without  internal  pull-up  resistors  Pins  22,  23,  33,  36,  and  37  have  pull-up  resistors. 
See  Tech  Memo  #115  for  testing  procedures.. 
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100  MAX 

i       ,  ^  2.025 

?      I**  MAX" 


TWW 


MIN 


H 


u  Si    ilj)  *  -^om'n 


40  LEAD  CERAMIC  "A"  or  "AL" 


40  LEAD  RELPACK  "B"  or  "BL" 


40  LEAD  CERDIP  "CL" 


40  LEAD  PLASTIC  "P"  or  "PL" 
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information  lur nished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliable  However,  no  responsibility  is  assumed  by  Western ,  Olg.tal 
Corporation  (or  its  use;  nor  (or  any  infringements  of  patents  or  other  rights  of  third  parties  which  may  result  from  is  use  No  license  is  granted by 
implication  or  otherwise  under  any  patent  or  patent  rights  of  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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TECHNICAL  MEMO 


WEST£f?jy  DIBITAl 

CORPORA        T       /       O       N 


.._„.  2445  McCabeWay 

MEMO:       169  Nine.  California  92714 

(714)557-3550  TWX  910-595-1139 

DEVICE:   WD1770/ 1772/ 1773 
TITLE:   Preliminary  Data  Sheet  Update 
DATE:   8/29/83 


The  following  information  represents  updates  to  the 
current  WD1770/72/73  Preliminary  Data  sheet.   These  updates 
are  performance  enhancements. 

THE  (Page  19}  Changed  from  MIN  150NS  to  MIN  200NS. 

TAH  (Page  19)  Changed  from  MIN  20NS  to  IONS. 

TWE  (Page  19}  Changed  from  MIN  150NS  to  MIN  200NS. 

4.    H  bit  in  Command  (Page  6  last  paragraph) 

Changed  from:   "If  the  hFlag  is  set  and  motor  on 
line  (Pin  20) " 

Changed  to:     "if  the  hFlag  is  NOT  set  and  motor 
on  line  (Pin  20) " 


1. 
2. 

3. 


WESTERN  DiGlTML 

CORPORA!/        ON 


WD1773  5V4"  Floppy  Disk  Controller/Formatter 


FEATURES 

.    100%  SOFTWARE  COMPATIBILITY  WITH 
WD1793 

•  BUILT-IN  DATA  SEPARATOR 

•  BUILT-IN  WRITE  PRECOMPENSATION 

•  SINGLE  (FM)  AND  DOUBLE  (MFM)  DENSITY 

•  28  PIN  DIP,  SINGLE  +5V  SUPPLY 

o   TTL  COMPATIBLE  INPUTS/OUTPUTS 

•  128,  256,  512  OR  1024  SECTOR  LENGTHS 

•  8-BIT  BI-DIRECTIONAL  HOST  INTERFACE 


DESCRIPTION 

The  WD1773  is  an  MOS/LSI  device  which  performs 
the  functions  of  a  51/»"  Floppy  Disk  Controller/ 
Formatter,  it  is  fully  software  compatible  with 
the  Western  Digital  WD1793-02,  allowing  the 
designer  to  reduce  parts  count  and  board  size  on  an 
existing  WD1793  based  design  without  software 
modifications, 

With  the  exception  of  the  enable  Precomp/Ready 
line,  the  WD1773  Is  identical  to  the  WD1770  con- 
troller. This  line  serves  as  both  a  READY  input  from 
the  drive  during  READ/STEP  operations,  and  as  a 
Write  Precompensation  enable  during  Write  opera- 
tions, A  built-in  digital  data  separator  virtually 
eliminates  all  external  components  associated  with 
data  recovery  in  previous  designs. 
The  WD1773  is  implemented  in  NMOS  silicon  gate 
technology  and  is  available  in  a  28  pin,  dual-in-line 
package. 


A1  l 
DALOC 
OAL1  C 
OAL2  C 
DAL3  C 
DAL4  C 

DAL6C 

OAL7C 


1 

^  28 

2 

27 

3 

26 

4 

25 

5 

24 

6 

23 

7 

22 

8 

21 

9 

20 

11 

18 

12 

17 

13 

16 

14 

15 

1  INTRO 
3DRQ 
3DDETJ 
JWPRT 
]fP_ 
IJTR00 
3WD 
DWG 

3  ENPJRDY 

DCLK 

DOiRC 

2  STEP 

Z3VCC 


PIN  DESIGNATION 


January,  1984 


PIN  DESCRIPTION 


PIN 
NUMBER 


5-12 


14 
15 
16 


18 


20 

21 
22 
23 

24 

25 

26 


PIN  NAME 


CHIP  SELECT 


READ/WRITE 


ADDRESS  0,1 


DATA  ACCESS  LINES 
0 THROUGH  7 


MASTER  RESET 

GROUND 
POWER  SUPPLY 
STEP 

DIRECTION 
CLOCK 


MNEMONIC 


CS 
R/W 


A0.A1 


DAL0-DAL7 


MR 


READ  DATA 


ENABLE  PRECOMP/ 
READY  LINE 


WRITE  GATE 
WRITE  DATA 


TRACK  00 


INDEX  PULSE 


WRITE  PROTECT 


GND 

vcc 

STEP 
DIRC 


CLK 

RD 

ENP/RDY 

WG 
WD 
TR00 

IP 


DOUBLE  DENSITY 
ENABLE 


WPRT 


DDEN 


FUNCTION 


A  logic  low  on  this  input  selects  the  chip  and 
enable  Host  communication  with  the  device, 
A  logic  high  on  this  lnp_ut_  controls  the 
placement  of  data  on  the  D0-D7  lines  from  a 
selected  register,  while  a  logic  low  causes  a 
write  operation  to  a  selected  register. 

These  two  inputs  select  a  register  to  Read/Write 
data: 

AO        RAW  =  1 


CS 

0 
0 
0 
0 


A1 


R/W: 


0       0    Status  Reg        Command  Reg 

0  1    Track  Reg  Track  Reg 

1  0    Sector  Reg        Sector  Reg 
1        1     Data  Reg  Data  Reg 

Eight  bit  bidirectional  bus  used  for  transfer  of 
data,  control,  or  status.  This  bus  is  enabled  by 
CS  and  R/W  Each  line  will  drive  one  TTL  load 
A  logic  low  pulse  on  this  line  resets  the  device 
and  initializes  the  status  register.  Internal  pull- 
up. 

Ground, 

+  5V  ±  5%  power  supply  input 

The  Step  output  contains  a  pulse  for  each  step 

of  the  drive's  R/W  head, 

The  Direction  output  Is  high  when  stepping  in 
towards  the  center  of  the  diskette,  and  low 
when  stepping  out, 

This  input  requires  a  free-running  40  to  60% 
duty  cycle  clock  (for  internal  timing)  at  8  MHZ 

±1%., 

This  active  low  input  is  the  raw  data  line 
containing  both  clock  and  data  pulses  from  the 
drive. 

Serves  as  a  READY  input  from  the  drive  during 
READ/STEP  operations  and  as  a  Write  Precomp 
enable  during  write  operations., 

This  output  is  made  valid  prior  to  writing  on  the 
diskette. 

FM  or  MFM  clock  and  data  pulses  are  placed  on 
this  line  to  be  written  on  the  diskette 

This  active  low  input  informs  the  WD1773  that 
the  drive's  R/W  heads  are  positioned  over  Track 
zero., 

This  active  low  input  informs  the  WD1773  when 
the  physical  index  hole  has  been  encountered 
on  the  diskette, 

This  input  is  sampled  whenever  a  Write 
Command  is  received,  A  logic  low  on  this 
line  will  prevent  any  Write  Command  from 
executing.,  Internal  pull-up. 

This  input  pin  selects  either  single  (FM)  or 
double  (MFM)  density.  When  DDEN  =  0,  double 
density  is  selected.  Internal  pull-up. 


PIN  DESCRIPTION  (CONTINUED) 


PIN 
NUMBER 

PIN  NAME 

MNEMONIC 

FUNCTION 

27 
28 

DATA  REQUEST 
INTERRUPT  REQUEST 

DRQ 
INTRQ 

This  active  high  output  indicates  that  the  Data 

Register  is  full  (on  a  Read)  or  empty  (on  a  Write 

operation). 

This  active  high  output  is  set  at  the  completion 

of  any  command  or  reset  a  read  of  the  Status 

Register 

EN_T 
EMP/RDYJ  ROY 

REA[ 

)Y 

H 
0 

s 

T 

1 

N 
T 
E 
R 
F 
A 
C 
E 

5 'A" 

F 
L 

o 

P 
P 
Y 

D 

R 
1 
V 

E 

CLK 

WD1773 

GND  VCC 

WG 

pi           rs 

WO 

D0-D7 

M             V 

AO 

^      RD 

fP 

A1 

S3     , 

R/W 

TR0O 

m 

WPRT 

DRO 

DIRC 

INTRQ 

STEP 

+  5 

^. 

1    1    1 

+  RV 

WD1773  SYSTEM  BLOCK  DIAGRAM 


ARCHITECTURE 

The  Floppy  Disk  Formatter  block  diagram  is  il- 
lustrated on  page  4,  The  primary  sections  include 
the  parallel  processor  interface  and  the  Floppy  Disk 
interface. 

Data  Shift  Register  —  This  8-bit  register  assembles 
serial  data  from  the  Read  Data  input  (RD)  during  Read 
operations  and  transfers  serial  data  to  the  Write  Data 
output  during  Write  operations. 
Data  Register  —  This  8-bit  register  is  used  as  a 
holding  register  during  Disk  Read  and  Write  opera- 
tions. In  Disk  Read  operations,  the  assembled  data 
byte  is  transferred  in  parallel  to  the  Data  Register 
from  the  Data  Shift  Register.  In  Disk  Write  operations, 
information  is  transferred  in  parallel  from  the  Data 
Register  to  the  Data  Shift  Register. 
When  executing  the  Seek  command,  the  Data  Regis- 
ter holds  the  address  of  the  desired  Track  position. 


This  register  is  loaded  from  the  DAL  and  gated  onto 
the  DAL  under  processor  control- 
Track  Register  —  This  8-bit  register  holds  the  track 
number  of  the  current  Read/Write  head  position.  It  is 
incremented  by  one  every  time  the  head  is  stepped  in 
and  decremented  by  one  when  the  head  is  stepped 
out  (towards  track  00).  The  contents  of  the  register 
are  compared  with  the  recorded  track  number  in  the 
ID  field  during  disk  Read,  Write,  and  Verify  opera- 
tions. The  Track  Register  can  be  loaded  from  or 
transferred  to  the  DAL  This  Register  should  not  be 
loaded  when  the  device  is  busy. 
Sector  Register  (SR)  —  This  8-bit  register  holds  the 
address  of  the  desired  sector  position.  The  contents 
of  the  register  are  compared  with  the  recorded  sector 
number  in  the  ID  field  during  disk  Read  or  Write 
operations.  The  Sector  Register  contents  can  be 
loaded  from  or  transferred  to  the  DAL  This  register 
should  not  be  loaded  when  the  device  is  busy. 
Command  Register  (CR)  —  This  8-bit  register  holds 
the  command  presently  being  executed.  This  register 
should  not  be  loaded  when  the  device  is  busy  unless 
the  new  command  is  a  force  interrupt.  The  command 
register  can  be  loaded  from  the  DAL,  but  not  read 
onto  the  DAL 

Status  Register  (STR)  —  This  8-bit  register  holds 
device  Status  information.  The  meaning  of  the  Status 
bits  is  a  function  of  the  type  of  command  previously 
executed,  This  register  can  be  read  onto  the  DAL,  but 
not  loaded  from  the  DAL 

CRC  Logic  —  This  logic  is  used  to  check  or  to 
generate  the  16-bit  Cyclic  Redundancy  Check  (CRC). 
The  polynomial  is: 
G(x)  -  x16  +  x12  +  x5  +  L 
The  CRC  includes  all  information  starting  with  the 
address  mark  and  up  to  the  CRC  characters.  The 
CRC  register  is  preset  to  ones  prior  to  data  being 
shifted  through  the  circuit. 

Arithmetic/Logic  Unit  (ALU)  —  The  ALU  is  a  serial 
comparator,  incrementer,  and  decrementer  and  is 
used  for  register  modification  and  comparisons  with 
the  disk  recorded  ID  field. 
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DATA  OUT 
BUFFERS 
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COMMAND 
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REG 


AM  DETECTOR 
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TRACK 
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"Wri 
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Ir 
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PRECOMP 
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MR 

eg 
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ft 

AO 

A1 
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CONTROL 


WPRT 

IP 

Troo 

STEP 

DIRC 

ft 

RDY 

WD1773  BLOCK  DIAGRAM 


Timing  and  Control  —  All  computer  and  Floppy  Disk 
interface  controls  are  generated  through  this  logic. 
The  interna!  device  timing  is  generated  from  an  exter- 
nal crystal  clock.  The  WD1773  has  two  different 
modes  of  operation  according  to  the  state  of  DDEN. 
When  DDEN  =  0,  double  density  (MFM)  is  enabled. 
When  DDEN  =  1,  single  density  is  enabled, 
AM  Detector  —  The  address  mark  detector  detects 
ID,  data  and  index  address  marks  during  read  and 
write  operations. 

Data  Separator  —  A  digital  data  separator  consisting 
of  a  ring  shift  register  and  data  window  detection 
logic  provides  read  data  and  a  recovery  clock  to  the 
AM  detector. 


PROCESSOR  INTERFACE 

The  interface  to  the  processor  is  accomplished 
through  the  eight  Data  Access  Lines  (DAL)  and 
associated  control  signals.  The  DAL  are  used  to 
transfer  Data,  Status,  and  Control  words  out  of,  or  in- 
to the  WD1773.  The  DAL  are  three  state  buffers  that 
are  enabled  as  output  drivers  when  Chip  Select  (CS) 
and  R/W  =  1  are  active  or  act  as  input  receivers  when 
CS  and  R/W  =  0  are  active. 

When  transfer  of  data  with  the  Floppy  Disk  Controller 
is  required  by  the  host  processor,  the  device  address 
is  decoded  and  CS  is  made  tow.  The  address  bits  A1 
and  AO,  combined  with  the  signal  R/W  during  a  Read 
operation  or  Write  operation  are  interpreted  as  select- 
ing the  following  registers: 


A1  ■  AO       REAP  (RAW  =  1)        WRITE  <R/W  =  Q) 


0  0  Status  Register 

0  1  Track  Register 

1  0  Sector  Register 
1  1  Data  Register 


Command  Register 
Track  Register 
Sector  Register 
Data  Register 


During  Direct  Memory  Access  (DMA)  types  of  data 
transfers  between  the  Data  Register  of  the  WD1773 
and  the  processor,  the  Data  Request  (DRQ)  output 
is  used  in  Data  Transfer  control  This  signal  also 
appears  as  status  bit  1  during  Read  and  Write 
operations,. 

On  Disk  Read  operations  the  Data  Request  is  acti- 
vated {set  high)  when  an  assembled  serial  input  byte 
is  transferred  in  parallel  to  the  Data  Register.  This  bit 
is  cleared  when  the  Data  Register  is  read  by  the  pro- 
cessor. If  the  Data  Register  is  read  after  one  or  more 
characters  are  lost,  by  having  new  data  transferred  in- 
to the  register  prior  to  processor  reaooux,  the  Lost 
Data  bit  is  set  in  the  Status  Register.  The  Read  opera- 
tions continues  until  the  end  of  sector  is  reached. 
On  Disk  Write  operations  the  Data  Request  is  ac- 
tivated when  the  Data  Register  transfers  its  contents 
to  the  Data  Shift  Register,  and  requires  a  new  data 
byte,  It  is  reset  when  the  Data  Register  is  loaded  with 
new  data  by  the  processor.  If  new  data  is  not  loaded 
at  the  time  the  next  serial  byte  is  required  by  the 
Floppy  Disk,  a  byte  of  zeroes  is  written  on  the 
diskette  and  the  Lost  Data  is  set  in  the  Status 
Register. 

At  the  completion  of  every  command  an  INTRO  is 
generated,.  INTRQ  is  reset  by  either  reading  the 
status  register  or  by  loading  the  command  register 
with  a  new  command.  In  addition,  INTRQ  is  gen- 
erated if  a  Force  Interrupt  command  condition  is  met,, 
The  WD1773  has  two  modes  of  operation  according 
to  the  state  DDEN  (Pin  26).  When  DDEN  =  1,  single 
density  is  selected.  In  either  case,  the  CLK  input  {Pin 
18)  is  at  8  MHZ 

GENERAL  DISK  READ  OPERATIONS 

Sector  lengths  of  128, 256, 512  or  1024  are  obtainable 
in  either  FM  or  MFM  formats.  For  FM,  DDEN  should 
be  placed  to  logical  "1"  For  MFM  formats,  DDEN 
should  be  placed  to  a  logical  "O!*  Sector  lengths  are 
determined  at  format  time  by  the  fourth  byte  in  the 
"ID"  field, 


SECTOR  LENGTH  TABLE 


SECTOR  LENGTH 
FIELD  (HEX) 


NUMBER  OF  BYTES 
IN  SECTOR  (DECIMAL) 


00 
01 
02 
03 


128 

256 

512 

1024 


number  of  tracks  as  far  as  the  WD1773  is  concerned 
is  from  0  to  255  tracks, 

GENERAL  DISK  WRITE  OPERATION 

When  writing  is  to  take  place  on  the  diskette  the 
Write  Gate  (WG)  output  is  activated,  allowing  current 
to  flow  into  the  Read/Write  head  As  a  precaution  to 
erroneous  writing  the  first  data  byte  must  be  loaded 
into  the  Data  Register  in  response  to  a  Data  Request 
from  the  device  before  the  Write  Gate  signal  can  be 
activated, 

Writing  is  inhibited  when  the  Write  Protect  input  is  a 
logic  low,  in  which  case  any  Write  command  is  im- 
mediately terminated,  an  interrupt  is  generated  and 
the  Write  Protect  status  bit  is  set 
For  Write  operations,  the  WD1773  provides  Write 
Gate  (Pin  21)  to  enable  a  Write  condition,  and  Write 
Data  (Pin  22)  which  consists  of  a  series  of  active  high 
mjises.  The?**  pulses  contain  both  Clock  and  Data  in- 
formation in  FM  and  MFM,  Write  Data  provides  the 
unique  missing  clock  patterns  for  recording  Address 
Marks. 

If  Precomp  Enable  (ENP)  is  active  when  WG  is 
asserted,  automatic  Write  Precompensation  takes 
place,  The  outgoing  Write  Data  stream  is  delayed  or 
advanced  from  nominal  by  125  nanoseconds  ac- 
cording to  the  following  table: 


PATTERN 

MFM 

FM 

X 

1 

1 

0 

Early 

N/A 

X 

0 

1 

1 

Late 

N/A 

0 

0 

0 

1 

Early 

N/A 

1 

0 

0 

0 

Late 

N/A 

Next  Bit  to  be  sent 
Current  Bit  sending 
Previous  Bits  sent 

Precompensation  is  typically  enabled  on  the  inner- 
most tracks  where  bit  shifts  usually  occur  and  bit 
density  is  at  its  maximun. 

COMMAND  DESCRIPTION 

The  WD1773  will  accept  eleven  commands.  Com- 
mand words  should  only  be  loaded  in  the  Command 
Register  when  the  Busy  status  bit  is  off  (Status  bit  0). 
The  one  exception  is  the  Force  Interrupt  command 
Whenever  a  command  is  being  executed,  the  Busy 
status  bit  is  set,  When  a  command  is  completed,  an 
interrupt  is  generated  and  the  Busy  status  bit  is  reset. 
The  Status  Register  indicates  whether  the  completed 
command  encountered  an  error  or  was  fault  frea  For 
ease  of  discussion,  commands  are  divided  into  four 
types.  Commands  and  types  are  summarized  in 
Tablet, 


The  number  of  sectors  per  tract  as  far  as  the  WD1773 
is  concerned  can  be  from  1  to  255  sectors  The 


TABLE  1.     COMMAND  SUMMARY 


BITS 

TYPE     COMMAND 

7 

6 

5 

4 

3 

2 

1 

0 

I     Restore 

0 

0 

0 

0 

h 

V 

"*1 

ro 

Seek 

0 

0 

0 

1 

h 

V 

n 

ro 

I    Step 

0 

0 

1 

T 

h 

V 

n 

m 

I    Step-in 

0 

1 

0 

T 

h 

V 

n 

ro 

I    Step-out 

0 

1 

1 

T 

h 

V 

ri 

ro 

II    Read  Sector 

0 

0 

m 

I 

F 

II 

0 

I!    Write  Sector 

0 

1 

m 

I 

F 

If 

ao 

III    Read  Address 

1 

0 

0 

0 

F 

II 

0 

III    Read  Track 

1 

1 

0 

0 

F 

II 

0 

ill    Write  Track 

1 

1 

1 

n 

F 

il 

n 

IV   Force  Interrupt 

1 

0 

1 

l3 

l2 

h 

k> 

FLAG  SUMMARY 


COMMAND 
TYPE 

BIT 
NO{S) 

DESCRIPTION 

0,1 

H  ro  =  Stepping  Motor  Rate 
See  Table  3  for  Rate  Summary 

2 

V  =  Track  Number  Verify  Flag 

V  =  0,  No  verify 

V  =  1,  Verify  on  destination  track 

3 

h  =  Don't  Care 

4 

T  =  Track  Update  Flag 

T   =  0,  No  update 

T   =  1,  Update  track  register 

li 

0 

a0  =  Data  Address  Mark 

ao~  0,  FB{DAM) 

a0~  1.F8  (deleted  DAM) 

II 

1 

C  =  Side  Compare  Flag 

C  =  0,  Disable  side  compare 
C  =  1,  Enable  side  compare 

ll&lil 

1 

U  =  Update  SSO 

U   =  0,  Update  SSO  to  0 
U   ~  1,  Update  SSO  to  1 

II  &  111 

2 

E  =  15  MS  Delay 

E    =  0,  No  30  MS  delay 
E   =  1,15  MS  delay 

II 

3 

S  =  Side  Compare  Flag 

S   =  0,  Compare  for  side  0 
S   =  1,  Compare  for  side  1 

II 
II 

3 

4 

L  =  Sector  Length  Flag 

LSB's  Sector  Length  in  ID  Field 
00          01           10          11 

L    =  0         256         512         1024 

128 

L    =  1          128         256          512 

1024 

m  =  Multiple  Record  Flag 

m  =  0,  Single  record 
m  =  1,  Multiple  records 

IV 

0-3 

Jx         -  Interrupt  Condition  Flags 

0  =  1  Not  Ready  To  Ready  Transition 

1  =  1  Ready  To  Not  Ready  Transition 

2  =  1  Index  Pulse 

3  =1  Immediate  Interrupt,  Requires  A  Reset 
'3-h      =  0  Terminate  With  No  Interrupt  (INTRQ) 

NOTE:  See  Type  I 

V  Comman 

d  Description  for  further  inforrnatio 

n 

TYPE  1  COMMANDS 

The  Type  I  Commands  include  the  Restore,  Seek, 
Step,  Step-in,  and  Step-Out  commands.  Each  of  the 
Type  I  Commands  contains  a  rate  field  (r0  H),  which 
determines  the  stepping  motor  rate  as  defined  in 
Table  3, 

A  4  /is  (MFM)  or  8  ^ts  (FM)  pulse  is  provided  as  an 
output  to  the  drive.  For  every  step  pulse  issued,  the 
drive  moves  one  track  location  in  a  direction  deter- 
mined by  the  direction  output,  The  chip  will  step  the 
drive  in  the  same  direction  it  last  stepped  unless  the 
command  changes  the  direction. 

The  Direction  signal  is  active  high  when  stepping  in 
and  low  when  stepping  out  The  Direction  signal  is 
valid  24  or  48  ^sec  before  the  first  stepping  pulse  is 
generated. 

When  a  Seek,  Step  or  Restore  command  is  executed 
an  optional  verification  of  Read-Write  head  position 
can  be  performed  by  settling  bit  2  (V  =  1)  in  the 
command  word  to  a  logic  1  The  verification  opera- 
tion begins  at  the  end  of  the  30  msec  settling  time. 
The  track  number  from  the  first  encountered  ID  Field 
is  compared  against  the  contents  of  the  Track  Regis- 
ter If  the  track  numbers  compare  and  the  ID  Field 
Cyclic  Redundancy  Check  (CRC)  is  correct,  the  verify 
operation  is  complete  and  an  INTRQ  is  generated 
with  no  errors,.  If  there  is  a  match  but  not  a  valid  CRC, 
the  CRC  error  status  bit  is  set  (Status  bit  3),  and  the 
next  encountered  ID  field  is  read  from  the  disk  for  the 
verification  operation. 

The  WD1773  must  find  an  ID  field  with  correct  track 
number  and  correct  CRC  within  5  revolutions  of  the 
media;  otherwise  the  seek  error  is  set  and  an  INTRQ 
is  generated,  If  V  =  0,  no  verification  is  performed 

RESTORE  (SEEK  TRACK  0)  

Upon  receipt  of  this  command  the  Track  00  (TR00) 
input  is  sampled  If  TROO  is  active  low  indicating  the 
Read-Write  head  is  positioned  over  track  0,  the  Track 
Register  is  loaded  with  zeroes  and  an  interrupt  is  gen- 
erated. If  TROO  is  not  active  low,  stepping  pulses  at  a 
rate  specified  by  the  M  rrj  field  are  issued  until  the 
TROO  input  is  activated.  At  this  time  the  Track 
Register  is  loaded  with  zeroes  and  an  interrupt  is 
generated.  If  the  TROO  input  does  not  go  active  low 
after  255  stepping  pulses,  the  WD1773  terminates 
operation,  interrupts,  and  sets  the  Seek  error  status 
bit,  providing  the  V  flag  is  set,  A  verification  operation 
also  takes  place  if  the  V  flag  is  set  JNote  that  the 
Restore  command  is  executed  when  MR  goes  from 
an  active  to  an  inactive  state  and  that  the  DRQ  pin 
stays  tow, 

SEEK 

This  command  assumes  that  the  Track  Register 
contains  the  track  number  of  he  current  position  of 
the  Read-Write  head  and  the  Data  Register  contains 
the  desired  track  number.  The  WD1773  will  update 
the  Track  register  and  issue  stepping  pulses  in  the 
appropriate  direction  until  the  contents  of  the  Track 


register  are  equal  to  the  contents  of  the  Data  Reg- 
ister (the  desired  track  location)  A  verification 
operation  takes  place  if  the  V  flag  is  on  An  interrupt 
is  generated  at  the  completion  of  the  command 
Note:  When  using  multiple  drives,  the  track  register 
must  be  updated  for  the  drive  selected  before  seeks 
are  issued. 

STEP 

Upon  receipt  of  this  command,  the  WD1773  issues 
one  stepping  pulse  to  the  disk  drive,  The  stepping 
motor  direction  is  the  same  as  in  the  previous  step 
command.  After  a  delay  determined  by  the  nr0  field, 
a  verification  takes  place  if  the  V  flag  is  on.  If  the  U 
flag  is  on,  the  Track  Register  is  updated.  An  interrupt 
is  generated  at  the  completion  of  the  command, 

STEP-IN 

Upon  receipt  of  this  command,  the  WD1773  issues 
one  stepping  pulse  in  the  direction  towards  track  76. 
If  the  U  flag  is  on,  the  Track  Register  is  incremented 
by  one.  After  a  delay  determined  by  the  r1r0  field,  a 
verification  takes  place  if  the  V  flag  is  on.  An  interrupt 
is  generated  at  the  completion  of  the  command 

STEPOUT 

Upon  receipt  of  this  command,  the  WD1773  issues 
one  stepping  pulse  in  the  direction  towards  track  0.  If 
the  U  flag  is  on,  the  Track  Register  is  decremented  by 
one.  After  a  delay  determined  by  the  r1f0  field,  a 
verification  takes  place  if  the  V  flag  is  on,  An  interrupt 
is  generated  at  the  completion  of  the  command. 

TYPE  II  COMMANDS 

The  Type  II  Commands  are  the  Read  Sector  and  Write 
Sector  commands.  Prior  to  loading  the  Type  II  Com- 
mand into  the  Command  Register,  the  computer 
must  load  the  Sector  Register  with  the  desired  sector 
number.  Upon  receipt  of  the  Type  II  command,  the 
busy  status  Bit  is  set.  The  E  flag  is  still  active  pro- 
viding a  delay  of  1  to  30  msec  for  head  settling  time 

When  an  ID  field  is  located  on  the  disk,  the  WD1773 
compares  the  Track  Number  on  the  ID  field  with  the 
Track  Register.  If  there  is  not  a  match,  the  next  en- 
countered ID  field  is  read  and  a  comparison  is  again 
made  If  there  was  a  match,  the  Sector  Number  of  the 
ID  field  is  compared  with  the  Sector  Register;  If  there 
is  not  a  Sector  match,  the  next  encountered  ID  field 
is  read  off  the  disk  and  comparisons  again  made.  If 
the  ID  field  CRC  is  correct,  the  data  field  is  then 
located  and  will  be  either  written  into,  or  read  from 
depending  upon  the  command.  The  WD1773  must 
find  an  ID  field  with  a  Track  number,  Sector  number, 
side  number,  and  CRC  within  five  revolutions  of  the 
disk;  otherwise,  the  Record  not  found  status  bit  is  set 
(Status  bit  3)  and  the  command  is  terminated  with  an 
interrupt. 

Each  of  the  Type  II  Commands  contains  an  (m)  flag 
which  determines  if  multiple  records  (sectors)  are  to 
be  read  or  written,  depending  upon  the  command.  If 
m  =  0,  a  single  sector  is  read  or  written  and  an  inter- 


TYPE  I  COMMAND  FLOW 

rupt  is  generated  at  the  completion  of  the  command, 
if  m  =  1,  multiple  records  are  read  or  written  with  the 
sector  register  internally  updated  so  that  an  address 
verification  can  occur  on  the  next  record,  The 
WD1773  will  continue  to  read  or  write  multiple 
records  and  update  the  sector  register  in  numerical 
ascending  sequence  until  the  sector  register  ex- 
ceeds the  number  of  sectors  on  the  track  or  until  the 
Force  Interrupt  command  is  loaded  into  the  Com- 
mand Register,  which  terminates  the  command  and 
generates  an  interrupt. 

For  example:  If  the  WD1773  is  instructed  to  read 
sector  27  and  there  are  only  26  on  the  track,  the 
sector  register  exceeds  the  number  available  The 
WD1773  will  search  for  5  disk  revolutions,  interrupt 
out,  reset  busy,  and  set  the  record  not  found  status 
bit. 

The  Type  II  commands  for  WD1773  contain  side 
compare  flags.  When  C  =  0  (Bit  1)  no  side  compar- 
ison is  made.  When  C  =  1,  the  LSB  of  the  side  num- 


0 


TYPE  I  COMMAND  FLOW 

ber  is  read  off  the  ID  Field  of  the  disk  and  compared 
with  the  contents  of  the  (S)  flag  (Bit  3).  If  the  S  flag 
compares  with  the  side  number  recorded  in  the  ID 
field,  the  WD1773  continues  with  the  ID  search.  If  a 
comparison  is  not  made  within  6  index  pulses,  the 
interrupt  line  is  made  active  and  the  Record-Not- 
Found  status  bit  is  set 

READ  SECTOR 

Upon  receipt  of  the  Read  Sector  command,  the  Busy 
status  bit  is  set,  and  when  an  ID  field  is  encountered 
that  has  the  correct  track  number,  correct  sector 
number,  correct  side  number,  and  correct  CRC,  the 
data  field  is  presented  to  the  computer.  The  Data 
Address  Mark  of  the  data  field  must  be  found  within 
30  bytes  in  single  density  and  43  bytes  in  double 
density  of  the  last  ID  field  CRC  byte;  if  not,  the  ID 
field  is  searched  for  and  verified  again  followed  by 
the  Data  Address  Mark  search.  If  after  5  revolutions 
the  DAM  cannot  be  found,  the  Record  Not  Found 
status  bit  is  set  and  the  operation  is  terminated 


!NTRQ  RESET  BUSY 


) 
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TYPE  I  COMMAND  FLOW 

When  the  first  character  or  byte  of  the  data  field  has 
been  shifted  through  the  DSR,  it  is  transferred  to  the 
DR,  and  DRQ  is  generated.  When  the  next  byte  is  ac- 
cumulated in  the  DSR,  it  is  transferred  to  the  DR  and 
another  DRQ  is  generated.  If  the  Computer  has  not 
read  the  previous  contents  of  the  DR  before  a  new 
character  is  transferred  that  character  is  tost  and  the 
Lost  Data  Status  bit  is  set.  This  sequence  continues 
until  the  complete  dta  field  has  been  inputted  to  the 
computer.  If  there  is  a  CRC  error  at  the  end  of  the 
data  field,  the  CRC  error  status  bit  is  set,  and  the 
command  is  terminated  (even  if  it  is  a  multiple  record 
command). 

At  the  end  of  the  Read  operation,  the  type  of  Data 
Address  Mark  encountered  in  the  data  field  is 
recorded  in  the  Status  Register  (Bit  5)  as  shown 
below: 

STATUS 

BITS 

1  Deleted  Data  Mark 

0  Data  Mark 


WRITE  SECTOR 

Upon  receipt  of  the  Write  Sector  command,  the  Busy 
status  bit  is  set,  When  an  ID  field  is  encountered  that 
has  the  correct  track  number,  correct  sector  number, 
correct  side  number,  and  correct  CRC,  a  DRQ  is  gen- 
erated. The  WD1773  counts  off  11  bytes  in  single 
density  and  22  bytes  in  double  density  from  the  CRC 
field  and  the  Write  Gate  (WG)  output  is  made  active  if 
the  DRQ  is  serviced  (i.e.,  the  DR  has  been  loaded  by 


SET  BUSY,  RESET  DRQ,  LOST 

DATA,  RECORD  NOT  FOUND  & 

STATUS  BITS5&6INTAQ 


(INTRO,  RESET  BUSY     A 
SET  WRITE  PROTECT    J 


TYPE  II  COMMAND  FLOW 

the  computer).  If  DRQ  has  not  been  serviced,  the 
command  is  terminated  and  the  Lost  Data  status  bit 
is  set.  If  the  DRQ  has  been  serviced,  the  WG  is  made 
active  and  six  bytes  of  zeroes  in  single  density  and  12 
bytes  in  double  density  are  then  written  on  the  disk. 
At  this  time  the  Data  Address  Mark  is  then  written  on 


the  disk  as  determined   by  the  ao  field  of  the 
command  as  shown  below: 


a0 


Data  Address  Mark  (Bit  0) 


1  Deleted  Data  Mark 

0  Data  Mark 

The  WD1773  then  writes  the  data  field  and  gener- 
ates DRQ's  to  the  computer.  If  the  DRQ  is  not 
serviced  in  time  for  continuous  writing  the  Lost 
Data  Status  Bit  is  set  and  a  byte  of  zeroes  is 
written  on  the  disk,  The  command  is  not  ter- 
minated, After  the  last  data  byte  has  been  written 
on  the  disk,  the  two-byte  CRC  is  computed 
internally  and  written  on  the  disk  followed  by  one 
byte  of  logic  ones  in  FM  or  in  MFM.  The  WG 
output  is  then  deactivated.  The  INTRQ  will  set  48 
Msec  (MFM)  or  96  ^sec  (FM)  after  the  last  CRC 
byte  is  written.  For  partial  sector  writing,  the 
proper  method  is  to  write  the  data  and  fill  the 
balance  with  zeroes,   By  letting  the  chip  fill  the 
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BRING  IN  SECTOR  LENGTH  FIELD 

STORE  LENGTH  IN  INTERNAL 

REGISTER 


0 


zeroes,  errors  may  be  masked  by  the  lost  data 
status  and  improper  CRC  Bytes, 

TYPE  II!  COMMANDS 

READ  ADDRESS 

Upon  receipt  of  the  Read  Address  command,  the 
Busy  Status  Bit  is  set.  The  next  encountered  ID 
field  is  then  read  in  from  the  disk,  and  the  six 
data  bytes  of  the  ID  field  are  assembled  and 
transferred  to  the  DR,  and  a  DRQ  is  generated  for 
each  byte.  The  six  bytes  of  the  ID  field  are 
shown  below: 


TRACK 
ADDR 

SIDE 
NUMBER 

SECTOR 
ADDRESS 

SECTOR 
LENGTH 

CRC 
1 

CRC 
2 

1 

2 

3 

4 

5 

6 

SNTRO.  RESET  BUSY 


JSY  J 


TYPE  II  COMMAND  FLOW 


TYPE  II  COMMAND  FLOW 
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TYPE  II  COMMAND 

Although  the  CRC  characters  are  transferred  to 
the  computer,  the  WD1773  checks  for  validity  and 
the  CRC  error  status  bit  is  set  if  there  is  a  CRC 
error.  The  Track  Address  of  the  ID  field  is  written 
into  the  sector  register  so  that  a  comparison  can 
be  made  by  the  user.  At  the  end  of  the  operation 
an  interrupt  is  generated  and  the  Busy  Status  is 
reset 

READ  TRACK 

Upon  receipt  of  the  READ  track  command,  the  Busy 
Status  bit  is  set  Reading  starts  with  the  leading  edge 
of  the  first  encountered  index  pulse  and  continues 
until  the  next  index  pulse.  All  Gap,  Header,  and  data 
bytes  are  assembled  and  transferred  to  the  data  reg- 
ister and  DRQ's  are  generated  for  each  byte.  The 
accumulation  of  bytes  is  synchronized  to  each  ad- 
dress mark  encountered.  An  interrupt  is  generated  at 
the  completion  of  the  command. 
This  command  has  several  characteristics  which 


make  it  suitable  for  diagnostic  purposes.  They  are: 
the  Read  Gate  is  not  activated  during  the  command; 
no  CRC  checking  is  performed;  gap  information  is 
included  in  the  data  stream;  the  internal  side  com* 
pare  is  not  performed;  and  the  address  mark  detector 
is  on  for  the  duration  of  the  command.  Because  the 
A.M.  detector  is  always  on,  write  splices  or  noise  may 
cause  the  chip  to  look  for  an  AM  If  an  address  mark 
does  not  appear  on  schedule  the  Lost  Data  status 
flag  is  set. 

The  ID  A.M.,  iD  field,  ID  CRC  bytes,  DAM,  Data,  and 
Data  CRC  Bytes  for  each  sector  will  be  correct  The 
Gap  Bytes  may  be  read  incorrectly  during  write-splice 
time  because  of  synchronization. 

WRITE  TRACK  FORMATTING  THE  DISK 

(Refer  to  section  on  Type  III  commands  for  flow 
diagrams) 

Formatting  the  disk  is  a  relatively  simple  task  when 
operating  programmed  I/O  or  when  operating  under 
DMA  with  a  large  amount  of  memory.  Data  and  gap 

;„*». — 1;.„„  . — ,,^-i  k^  r>»o>(iH^<-t  2%  the  computer  inter- 
face,. Formatting  the  disk  is  accomplished  by  posi- 
tioning the  R/W  head  over  the  desired  track  number 
and  issuing  the  Write  Track  command, 

Upon  receipt  of  the  Write  Track  command,  the  Busy 
Status  bit  is  set.  Writing  starts  with  the  leading  edge 
of  the  first  encountered  index  pulse  and  continues 
until  the  next  index  pulse,  at  which  time  the  interrupt 
is  activated  The  Data  Request  is  activated  immedi^ 
ately  upon  receiving  the  command,  but  writing  will 
not  start  until  after  the  first  byte  has  been  loaded  into 
the  Data  Register.  If  the  DR  has  not  been  loaded  by 
the  time  the  index  pulse  is  encountered  the  opera- 
tion is  terminated  making  the  device  Not  Busy,  the 
Lost  Data  Status  Bit  is  set,  and  the  Interrupt  is  ac- 
tivated. If  a  byte  is  not  present  in  the  DR  when 
needed,  a  byte  of  zeroes  is  substituted. 

This  sequence  continues  from  one  index  mark  to  the 
next  index  mark,  Normally,  whatever  data  pattern  ap- 
pears in  the  data  register  is  written  on  the  disk  with  a 
normal  clock  pattern.  However,  if  the  WD1773  de- 
tects a  data  pattern  of  F5  thru  FE  in  the  data  register, 
this  is  interpreted  as  data  address  marks  with 
missing  clocks  or  CRC  generation 

The  CRC  generator  is  initialized  when  any  data  byte 
from  F8  to  FE  is  about  to  be  tranf erred  from  the  DR  to 
the  DSR  in  FM  or  by  receipt  of  F5  in  MFM.  An  F7  pat- 
tern will  generate  two  CRC  characters  in  FM  or  MFM. 
As  a  consequence,  the  patterns  F5  thru  FE  must  not 
appear  in  the  gaps,  data  fields,  or  ID  fields.  Also, 
CRC's  must  be  generated  by  an  F7  pattern. 

Disks  may  be  formatted  in  IBM  3740  or  System  34 
formats  with  sector  lengths  of  128,  256,  512,  or  1024 
bytes, 

TYPE  IV  COMMANDS 

The  Forced  Interrupt  command  is  generally  used  to 


terminate  a  multiple  sector  read  or  write  command  or 
to  insure  Type  I  status  in  the  status  register.  This 
command  can  be  loaded  into  the  command  register 
at  any  time*  If  there  is  a  current  command  under 
execution  (busy  status  bit  set)  the  command  will  be 
terminated  and  the  busy  status  bit  reset. 

The  lower  four  bits  of  the  command  determine  the 
conditional  interrupt  as  follows: 

'0  =  Not-Ready  to  Ready  Transition 
h  =  Ready  to  Not-Ready  Transition 
'2  =  Every  Index  Pulse 
1 3  =  Immediate  Interrupt 


The  conditional  interrupt  is  enabled  when  the  cor- 
responding bit  positions  of  the  command  ('3  -  (0)  are 
set  to  a  1„  Then,  when  the  condition  for  interrupt  is 
met,  the  INTRQ  line  will  go  high  signifying  that  the 
condition  specified  has  occurred.  If*3  -  If)  are  all  set 
to  zero  (HEX  DO),  no  interrupt  will  occur  but  any 
command  presently  under  execution  will  be  immedi- 
ately terminated.  When  using  the  immediate  interrupt 
condition  {'3  -  1)  an  interrupt  will  be  immediately 
generated  and  the  current  command  terminated. 
Reading  the  status  or  writing  to  the  command 
register  will  not  automatically  clear  the  interrupt  The 
HEX  DO  is  the  only  command  that  will  enable  the 


*"(       RESET  Busy  ) 


TYPE  II!  COMMAND  WRITE  TRACK 


TYPE  II!  COMMAND  WRITE  TRACK 
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immediate  interrupt  {HEX  D8)  to  clear  on  a  sub- 
sequent load  command  register  or  read  status 
register  operation  Follow  a  HEX  D8  with  DO  com- 
mand, 

Wait  16  psec  (double  density)  or  32  nsec  (single 
density  before  issuing  a  new  command  after  issuing 
a  forced  interrupt.  Loading  a  new  command  sooner 
than  this  will  nullify  the  forced  interrupt 

Forced  interrupt  stops  any  command  at  the  end  of  an 
interna!  micro-instruction  and  generates  INTRQ 
when  the  specified  condition  is  met.  Forced  interrupt 
will  wait  until  ALU  operations  in  progress  are 
complete  (CRC  calculations,  compares,  etc.). 

More  than  one  condition  may  be  set  at  a  time.  If  for 
example,  the  READY  TO  NOT-READY  condition  (h 
=  1)  and  the  Every  Index  Pulse  (l2  =  1)  are  both  set, 
the  resultant  command  would  be  HEX  "DA".  The 
"OR"  function  is  performed  so  that  either  a  READY 
TO  NOT-READY  or  the  next  Index  Pulse  will  cause  an 
interrupt  condition 

STATUS  REGISTER 

Upon  receipt  of  any  command,  except  the  Force 
Interrupt  command,  the  Busy  Status  bit  is  set  and  the 
rest  of  the  status  bits  are  updated  or  cleared  for  the 
new  command,  if  the  Force  Interrupt  Command  is  re- 
ceived when  there  is  a  current  command  under  exe- 
cution, the  Busy  status  bit  is  reset,  and  the  rest  of  the 
status  bits  are  unchanged,.  If  the  Force  Interrupt  com- 
mand is  received  when  there  is  not  a  current  com- 
mand under  execution,  the  Busy  Status  bit  is  reset 
and  the  rest  of  the  status  bits  are  updated  or  cleared, 
In  this  case,  Status  reflects  the  Type  I  commands. 

The  user  has  the  option  of  reading  the  status  register 
through  program  control  or  using  the  DRQ  line  with 
DMA  or  interrupt  methods  When  the  Data  register  is 
read  the  DRQ  bit  in  the  status  register  and  the  DRQ 
tine  are  automatically  reset.  A  write  to  the  Data 
register  also  causes  both  DRQ's  to  reset, 

The  busy  bit  in  the  status  may  be  monitored  with  a 
user  program  to  determine  when  a  command  is  com- 
plete, in  lieu  of  using  the  INTRQ  line.  When  using  the 
INTRQ,  a  busy  status  check  is  not  recommended  be- 
cause a  read  of  the  status  register  to  determine  the 
condition  of  busy  will  reset  the  INTRQ  line. 

The  format  of  the  Status  Register  is  shown  below: 


(BITS) 

7 

6 

5 

4 

3 

2 

1 

0 

S7 

S6 

S5 

S4 

S3 

S2 

S1 

SO 

Because  of  interna!  sync  cycles,  certain  time  delays 
must  be  observed  when  operating  under  pro- 
grammed I/O,  They  are:  (times  double  when  clock  = 
1MHz) 


Operation 

Next  Operation 

Delay  ReqU 
FM           MFM 

Write  to 
Command  Reg. 

Read  Busy  Bit 
(Status  Bit  0) 

48fiS 

24fjs 

Write  to 
Command  Reg. 

Read  Status 
Bits  1-7 

64fjs 

32  pS 

Write 
Register 

Read  Any 
Register 

32  ms 

16ms 

IBM  3740  FORMAT  -  128  BYTES/SECTOR 

Shown  below  is  the  IBM  single-density  format  with 
128  bytes/sector  In  order  to  format  a  diskette,  the 
user  must  issue  the  Write  Track  command,  and  load 
i'uts  data  reyisiwi  wiih  Use  fuiiowiny  vaiubs.  Foi  eveiy 
byte  to  be  written,  there  is  one  Data  Request. 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

40 

FF(orOO)1 

6 

00 

1 

FC  (Index  Mark) 

26 

FF(orOO)1 
00 

6 

1 

FE  (ID  Address  Mark) 

1 

Track  Number 

1 

Side  Number  (00  or  01) 

1 

Sector  Number (1  thrulA) 

1 

00  (Sector  Length) 

1 

F7  (2  CRC's  written) 

11 

FF(orOO)' 

6 

00 

1 

FB  (Data  Address  Mark) 

128 

1 

Data  (IBM  uses  E5) 
F7  (2  CRC's  written) 

27 

FF(or00)< 
FF(orOO)' 

247** 

Status  varies  according  to  the  type  of  command  exe- 
cuted as  shown  in  Table  4, 


*Whte  bracketed  field  26  times 
*  Continue  writing  until  WD1 773  interrupts  out 
Approx,  247  bytes. 


IBM  SYSTEM  34  FORMAT  —  256  BYTES/SECTOR 

Shown  below  is  the  IBM  dual-density  format  with  256 
bytes/sector.  In  order  to  format  a  diskette  the  user 
must  issue  the  Write  Track  command  and  load  the 
data  register  with  the  following  values.  For  every  byte 
to  be  written,  there  is  one  data  request 
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(  ENTER  ] 


SET  BUSY 

RESET  STATUS 

BITS  2.  A.  5 


1NTRQ 
RESET  BUSY 


•If  TEST  ±  f  NO  DELAY 
If  TEST  ±  1  and  CLK  ±  1  MHZ.  30  MS  DELAY 


SHIFT  ONE  BIT 
INTO  DSR 


SET 
DRQ 


TYPE  III  COMMAND 

Read  Track/Address 


READ  ADDRESS 
SEQUENCE 


SHIFT  1  BYTE 
INTO  OSR 


TRANSFER 
BYTE  TO  OR 


TRANSFER  TRACK 

NUMBER  TO  SECTOR 

REGISTER 


SET  CRC 
ERROR  BIT 


SET  INTRO 
RESET  BUSY 


TYPE  III  COMMAND 

Read  Track/Address 


NUMBER 

HEX  VALUE  OF 

OF  BYTES 

BYTE  WRITTEN 

80 

4E 

12 

00 

3 

F6  (Writes  C2) 

1 

FC  (Index  Mark) 

*  50 

4E 
00 

12 

3 

F5  (Writes  A1) 

1 

FE  (ID  Address  Mark) 

1 

Track  Number  (0  thru  4C) 

1 

SideNumber(OoM) 

1 

Sector  Number  (1  thru  1  A) 

1 

01  (Sector  Length) 

1 

F7  (2  CRCs  written) 

22 

4E 

12 

00 

o 

F5  (Writes  A  i) 

1 

FB  (Data  Address  Mark) 

256 

DATA 

1 

F7  (2  CRCs  written) 

54 

4E 
4E 

598** 

'Write  bracketed  field  26  times 
'Continue  writing  until  WD1773  interrupts  out 
Approx,  598  bytes. 


1.  NON-IBM  FORMATS 

Variations  in  the  IBM  formats  are  possible  to  a 
limited  extent  if  the  following  requirements  are  met; 

1)  Sector  size  must  be  128, 256, 512  of  1024  bytes. 

2)  Gap  2  cannot  be  varied  from  the  IBM  format. 

3)  3  bytes  of  A1  must  be  used  in  MFM 

In  addition,  the  Index  Address  Mark  is  not  required 
for  operation.  Gap  1, 3,  and  4  lengths  can  be  as  short 
as  2  bytes,  however  PLL  lock  up  time,  motor  speed 
variation,  write-splice  area,  etc.  will  add  more  bytes  to 
each  gap  to  achieve  proper  operation.  It  is  recom- 
mended that  the  IBM  format  be  used  for  highest 
system  reliability. 


FM 

MFM 

Gap  I 

16  bytes  FF 

32  bytes  4E 

Gap  II 

1 1  bytes  FF 

22  bytes  4E 

* 

6  bytes  00 

12  bytes  00 
3  bytes  A1 

Gap  III** 

10  bytes  FF 
4  bytes  00 

24  bytes  4E 
8  bytes  00 
3  bytes  A1 

Gap  IV 

16  bytes  FF 

16  bytes  4E 

*Byte  counts  must  be  exact 
**Byte  counts  are  minimum,  except  exactly  3  bytes 
of  A1  must  be  written,, 
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DC  ELECTRICAL  CHARACTERISTICS 


MAXIMUM  RATINGS 

Storage  Temperature  . . 
Operating  Temperature  , 


. .   ~55°Cto  +  125°C 
0°C  to  70°C  Ambient 


Maximum  Voltage  to  Any  Input 
with  Respect  to  Vss 


(-15 to -0.3V) 


DC  OPERATING  CHARACTERISTICS 


TA  =  0°C  to  70°C,  Vss  =  OV,  Vcc  =  +  5V 

±„25V 

SYMBOL 

CHARACTERISTIC 

MIN. 

MAX. 

UNITS 

CONDITIONS 

IlL 

Input  Leakage 

10 

MA 

V|N  =  VCC 

IOL 

Output  Leakage 

10 

ma 

VOUT  =  Vcc 

V|H 

Input  High  Voltage 

2.0 

V 

V|L 

Input  Low  Voltage 

0.8 

V 

VOH 

Output  High  Voltage 

2.4 

V 

In-  -100mA 

vol 

Output  Low  Voltage 

0.40 

V 

l0  =  1.6  mA 

pd 

Power  Dissipation 

.75 

w 

RPU 

Internal  Pull-Up 

100 

1700 

,iA 

V|N  =  0V 

ice 

Supply  Current 

75(Typ) 

150 

mA 

AC  TIMING  CHARACTERISTICS 

TA  =  0°C  to  70°C,  Vss  =  0V,  Vqc  : 


+  5V  ±,.25V 


READ  ENABLE  TIMING  -  RE  such  that :  R/W  =  1,  CS 

=  0. 

SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TRE 

RE  Pulse  Width  of  CS 

200 

nsec 

Cl  =  50  pf 

TDRR 

DRQ  Reset  from  RE 

25 

100 

nsec 

TIRR 

INTRQ  Reset  from  RE 

8000 

nsec 

TDV 

Data  Valid  from  RE 

100 

200 

nsec 

Cl  =  50  pf 

TDOH 

Data  Hold  from  RE 

50 

150 

nsec 

Cl  =  50  pf 

Note:  DRQ  and  INTRQ  reset  are  from  rising  edge  {lagging)  of  RE,  whereas  resets  are  from  falling  edge  (leading) 
of  WE 

WRITE  ENABLE  TIMING  -  WE  such  that :  R/W  =  0,  CS  =  0. 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX, 

UNITS 

CONDITIONS 

TAS 

Setup  ADDR  to  CS 

50 

nsec 

TSET 

Setup  R/W  to  CS 

0 

nsec 

TAH 

Hold  ADDR  from  CS 

10 

nsec 

THLD 

Hold  R/W  fromCS 

0 

nsec 

TWE 

WE  Pulse  Width 

200 

nsec 

TDRW 

DRQ  Reset  from  WE 

100 

200 

nsec 

TiRW 

INTRQ  Reset  from  WE 

8000 

nsec 

TDS 

Data  Setup  to  WE 

150 

nsec 

TDH 

Data  Hold  from  WE 

0 

nsec 

17 
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WRITE  DATA  TIMING: 


cya/joni 

r»u  a  p  a  nTcoicTir* 

MIKI 

TYP. 

HflAV 

IfMtXO 

COrtDITiONS 

TWG 

Write  Gate  to  Write  Data 

4 
2 

jusec 
Hsec 

FM 
MFM 

TBC 

Write  Data  Cycle  Time 

4,6,8 

psec 

TWF 

Write  Gate  off  from  WD 

4 
2 

H$ec 
nsec 

FM 
MFM 

TWP 

Write  Data  Pulse  Width 

820 

690 

570 

1380 

nsec 
nsec 
nsec 
nsec 

Early  MFM 

Nominal  MFM 

Late  MFM 

FM 

INPUT  DATA  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX. 

UNITS 

CONDITIONS 

TPW 
TBC 

Raw  Read  Pulse  Width 
Raw  Read  Cycle  Time 

200 
3000 

3000 

nsec 
nsec 

MISCELLANEOUS  TIMING: 


SYMBOL 

CHARACTERISTIC 

MIN. 

TYP. 

MAX„ 

UNITS 

CONDITIONS 

TCDi 

Clock  Duty  (tow) 

50 

67 

nsec 

(60/40) 

TCD2 

Clock  Duty  (high) 

50 

67 

nsec 

(40/60) 

TSTP 

Step  Pulse  Output 

4 
8 

/isec 

MFM 
FM 

TDIR 

Dir  Setup  to  Step 

24 
48 

jjsec 

MFM 

FM 

TMR 

Master  Reset  Pulse  Width 

50 

Msec 

TIP 

Index  Pulse  Width 

20 

ptsec 

ip  v- 


L* T!P »| 


MR   J- 


|"«f-TCYC-&-| 


h — TMR — H 


CD2 


DlflC    ^H- 

vol 


~R.,R0*-^ 


:Kl 


|«*-tDIR-*HtSTp|-< »*|TSTpL|~- U_TDsr-W  U* — TSPT 


rL_n 


«OL 


-it 


n_ 
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Package  Diagrams 


tSMIN        _>J        -620         l* 

1  fM1N  |F==K 


10OTYP  120M1NJ 


tL 


015  L-_-6!0^, 


28  LEAD  PLASTIC  "FT  or  "PH" 


28  LEAD  CERDIP  "CH" 


Information  furnished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliable  However,  no  responsibility  is  assumed  by  Western  Digital 
Corporation  (or  its  use;  nor  lor  any  Infringements  of  patents  or  other  rights  of  third  parties  which  may  result  from  Its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  patent  rights  of  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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WESTERN  OISiTML 

CORPORATION 

WD9216-00/WD9216-01 
Floppy  Disk  Data  Separator  —  FDDS 


FEATURES 

•  PERFORMS  COMPLETE  DATA  SEPARATION 
FUNCTION  FOR  FLOPPY  DISK  DRIVES 

•  SEPARATES  FM  OR  MFM  ENCODED  DATA 
FROM  ANY  MAGNETIC  MEDIA 

•  ELIMINATES  SEVERAL  SSI  AND  MSI  DEVICES 
NORMALLY  USED  FOR  DATA  SEPARATION 

•  NO  CRITICAL  ADJUSTMENTS  REQUIRED 

•  COMPATIBLE  WITH  WESTERN  DIGITAL  179X, 
176X  AND  OTHER  FLOPPY  DISK 
CONTROLLERS 

•  3fv"tALl_  irrill    UU/-Vt--li'«-L.nNL.    I   nOl\nUL 

•  +  5  VOLT  ONLY  POWER  SUPPLY 

•  TTL  COMPATIBLE  INPUTS  AND  OUTPUTS 


GENERAL  DESCRIPTION 

The  Floppy  Disk  Data  Separator  provides  a  low  cost 
solution  to  the  problem  of  converting  a  single  stream 
of  pulses  from  a  floppy  disk  drive  into  separate  Clock 
and  Data  inputs  for  a  Floppy  Disk  Controller 
The  FDDS  consists  primarily  of  a  clock  divider,  a 
long-term  timing  corrector,  a  short-term  timing 
corrector,  and  reciocking  circuitry.  Supplied  in  an  8- 
pin  Duai-ln-Line  package  to  save  board  real  estate, 
the  FDDS  operates  on  +  5  volts  only  and  is  TTL  com- 
patible on  all  inputs  and  outputs 
The  WDS215  is  av2i!2b!e  in  two  versions;  the 
WD9216-00,  which  is  intended  for  51/4"  disks  and  the 
WD9216-01  for5V4"  and  8"  disks. 
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REFCLK > 

CDO »- 

CD1 +■ 

DSKD~~-*»- 

CLOCK 
DIVIDER 

—  +5V 

' 

DATA /CLOCK 

SEPARATION 

LOGIC 

PULSE 

REGENERATION 

LOGIC 

— *-■    SEPCLK 

— *.    SEPD 

' 

EDGE 

DETECTION 

LOGIC 

FLOPPY  DISK  DATA  SEPARATOR  BLOCK  DIAGRAM 


o 

CO 

ro 
o> 
o 
o 

a 

CD 

to 
o 


ELECTRICAL  CHARACTERISTICS 

MAXIMUM  RATINGS* 

Operating  Temperature  Range. . .  0°C  to  +70°C 

Storage  Temperature  Range -55pCto125°C 

Positive  Voltage  on  any  Pin, 

with  respect  to  ground . .  +  8.0V 

Negative  Voltage  on  any  Pin, 

with  respect  to  ground , -0.3V 

•Stresses  above  those  listed  may  cause  permanent 
damage  to  the  device.  This  is  a  stress  rating  only 
and  functional  operation  of  the  device  at  these  or  at 
any  other  condition  above  those  indicated  in  the 
operational  sections  of  this  specification  is  not 
implied- 


NOTE:  When  powering  this  device  from  laboratory  or 
system  power  supplies,  it  is  important  that  the 
Absolute  Maximum  Ratings  not  be  exceeded  or 
device  failure  can  result.,  Some  power  supplies 
exhibit  voltage  spikes  or  "glitches"  on  their  outputs 
when  the  AC  power  is  switched  on  and  off.  In  ad- 
dition, voltage  transients  on  the  AC  power  tine  may 
appear  on  the  DC  output.  If  this  possibility  exists  it  is 
suggested  that  a  damp  circuit  be  used, 


OPERATING  CHARACTERISTICS 0~A  =  0°Cto70°C,  Vqc  = 

+  5V± 

5%,  unless  otherwise  noted) 

PARAMETER 

MIN. 

TYP. 

MAX. 

UNITS 

COMMENTS 

D.C.  CHARACTERISTICS 

INPUT  VOLTAGE  LEVELS 

Low  Level  V||_ 

0,8 

V 

High  Level  V|h 

2.0 

V 

OUTPUT  VOLTAGE  LEVELS 

Low  Level  Vol 

0,4 

V 

lOL  =  1.6mA 

High  Level  Voh 

24 

V 

lOH  =  -  100mA 

INPUT  CURRENT 

Leakage  l||_ 

10 

ma 

0<V|n<Vdd 

INPUT  CAPACITANCE 

Ail  Inputs 

10 

PF 

POWER  SUPPLY  CURRENT 

IDD 

50 

rnA 

A,C.  CHARACTERISTICS 

Symbol 

fCY           REFCLK  Frequency 

0,2 

4.3 

MHz 

WD  9216-00 

fCY           REFCLK  Frequency 

0,2 

8  3 

MHz 

WD  9216-01 

tCKH         REFCLK  High  Time 

50 

2500 

ns 

tCKL         REFCLK  Low  Time 

50 

2500 

ns 

tsnotM       REFCLK  to  SEPD  "ON"  Delay 

100 

ns 

tSDOFF     REFCLK  to  SEPD  "OFF"  Delay 

100 

ns 

tSPCK       REFCLK  to  SEPCLK  Delay 

100 

ns 

tDLL          DSKD  Active  Low  Time 

0.1 

100 

MS 

tDLH         DSKD  Active  High  Time 

0,2 

100 

MS 

«s             *CV           *- 

REFCLK a' 

^CKHb* 

^CKL*- 

r       { 

r      \       / 

\ 

/ 

-       \ 

tsr. 

)ON 

«* — *» 

tSDOFF 

SEPD                     \ 

/ 

, 

•« — *■ 

^ 

« — tow — *■ 

DSKD                                             \ 

t 

Figure  3.     AC  CHARACTERISTICS 
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DESCRIPTION  OF  PIN  FUNCTIONS 

PEN 

NUMBER 

PIN  NAME 

SYMBOL 

FUNCTION 

1 

Disk  Data 

DSKD 

Data  input  signal  direct  from  disk  drive.  Con- 
tains combined  clock  and  data  waveform, 

2 

Separated  Clock 

SEPCLK 

Clock  signal  output  from  the  FDDS  derived 
from  floppy  disk  drive  serial  bit  stream. 

3 

Reference  Clock 

REFCLK 

Reference  clock  input 

4 

Ground 

GND 

Ground 

5,6 

Clock  Divisor 

CDO,  CD1 

CDO  and  CD1  control  the  internal  clock  divider 
circuit  The  internal  clock  is  a  submultiple  of  the 
REFCLK  according  to  the  following  table: 
CD1           CDO             Divisor 
0                0                    1 

0  1                    2 

1  0                    4 

7 

_D 

1                 1                     8 
SEPD  is  the  data  output  of  the  FDDS 

Separated  Data 

8 

Power  Supply 

vcc 

+  5  volt  power  supply 

3 

a 

CO 

to 
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4  MHz  CRYSTAL 
OSCILLATOR 

+  4 

1MHz 

" 

' 

' 

w 

FLOPPY 
DISK 

DRIVE 

REFCLK 

REGENERATED  DATA 

CI 

„K 

DERIVED  CLOCK 

WD179X,  176Xor  Equiv 
FLOPPY  DISK 
CONTROLLER 

RCLK 

DISK  DATA 

DSKD 

WD9216-00,  01 

SEPCLK 
CDO     CD1 

♦  ♦ 

GND    GND 

Figure  1. 

TYPICAL  SYSTEM  CONFIGURATION 

{SVa  "  Drive,  Double  Density) 


OPERATION 

A  reference  clock  (REFCLK)  of  between  2  and  8  MHz 
is  divided  by  the  FDDS  to  provide  an  internal  clock. 
The  division  ratio  is  selected  by  inputs  CDO  and  CD1 
The  reference  clock  and  division  ratio  should  be 
chosen  per  tablet 

The  FDDS  detects  the  leading  edges  of  the  disk  data 
pulses  and  adjusts  the  phase  of  the  internal  clock  to 
provide  the  SEPARATED  CLOCK  output 


Separate  short  and  long  term  timing  correctors 
assure  accurate  clock  separation. 

The  internal  clock  frequency  is  nominally  16  times 
the  SEPCLK  frequency.  Depending  on  the  internal 
timing  correction,  the  internal  clock  may  be  a 
minimum  of  12  times  to  a  maximum  of  22  times  the 
SEPCLK  frequency 

The  reference  clock  (REFCLK)  is  divided  to  provide 
the  internal  clock  according  to  pins  CDO  and  CDt. 
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TABLE  1: 
CLOCK  DIVIDER  SELECTION  TABLE 


DRIVE 

(8ffor5Y4") 

DENSITY 
(DDorSD) 

REFCLK 
MHz 

CD1 

CDO 

REMARKS 

8 
8 
8 

DD 
SD 
SD 

8 
8 

4 

0 
0 
0 

0 

1 

0 

>     Select  either  one 

5V4 
5V4 

DD 
DD 

8 

4 

0 
0 

1 

0 

>     Select  either  one 

5V4 
5V4 
5V4 

SD 
SD 
SD 

8 

4 
2 

1 

0 
0 

0 

1 

0 

>     Select  any  one 

jijijijiJxrirLRnjnjTJxrixLr^ 


SEPCLK 
SEPD  - 


U 


always  two  internal  clock  cycles 


See  page  725  for  ordering  information. 


Figure  2, 


information  furnished  by  Western  Digital  Corporation  is  believed  to  be  accurate  and  reliable  However,  no  responsibility  is  assumed  by  Western  Digital 
Corporation  tor  its  use;  nor  lor  any  infringements  of  patents  or  other  rights  ol  third  parties  which  may  result  from  its  use  No  license  is  granted  by 
implication  or  otherwise  under  any  patent  or  paten!  rights  of  Western  Digital  Corporation  Western  Digital  Corporalion  reserves  the  right  to  change 
specifications  at  anytime  without  notice 
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CORPORATION 

TR1863/TR1865 
Universal  Asynchronous  Receiver/Transmitter  (UART) 


FEATURES 

•  SINGLE  POWER  SUPPLY  —  +5VDC 

•  D.a  TO  1  MHZ  (64  KB)  (STANDARD  PART) 
TR1 863/5 

•  FULL  DUPLEX  OR  HALF  DUPLEX  OPERATION 
»   AUTOMATIC  INTERNAL  SYNCHRONIZATION 

OF  DATA  AND  CLOCK 

•  AUTOMATIC  START  BIT  GENERATION 

•  EXTERNALLY  SELECTABLE 
Word  Length 

Baud  Rate 

Even/Odd  Parity  (Receiver/Verification  — 

Tt  ai  ibi  r  liuei/Gei  lerauui  t) 

Parity  inhibit 

One,  One  and  One-Half,  or  Two  Stop  Bit 

Generation  (11/2  at  5  Bit  Level) 

•  AUTOMATIC  DATA  RECEIVED/TRANSMITTED 
STATUS  GENERATION 

Transmission  Complete 

Buffer  Register  Transfer  Complete 

Received  Data  Available 

Parity  Error 

Framing  Error 

Overrun  Error 

•  BUFFERED  RECEIVER  AND  TRANSMITTER 
REGISTERS 


THREE-STATE  OUTPUTS 

Receiver  Register  Outputs 

Status  Flags 

TTL  COMPATIBLE 

TR1865  HAS  PULL-UP  RESISTORS  ON  ALL 

INPUTS 


APPLICATIONS 

PERIPHERALS 

TERMINALS 

MINICOMPUTERS 

FACSIMILE  TRANSMISSION 

MODEMS 

CONCENTRATORS 

ASYNCHRONOUS  DATA  MULTIPLEXERS 

CARD  AND  TAPE  READERS 

PRINTERS 

DATA  SETS 

CONTROLLERS 

KEYBOARD  ENCODERS 

REMOTE  DATA  ACQUISITION  SYSTEMS 

ASYNCHRONOUS  DATA  CASSETTES 


00 

w 
2 

00 

01 


vccn 

1.^ 

40 

3 

NCC 

2 

39 

3 

vssc 

3 

38 

3 

RRDC 

4 

37 

3 

RR8C 

5 

36 

3 

RR?c 

6 

35 

3 

RR6C 

7 

34 

3 

RR5C 

8 

33 

3 

HR4C 

9    

132 

3 

BR3C 

10 

]  31 

3 

RR2£ 

11 

30 

3 

HRl  C 

12l 

J  29 

3 

PEC 

13 

28 

3 

FEC 

14 

27 

3 

OEC 

15 

26 

3 

SFDt 

16 

25 

3 

RRCC 

17 

24 

3 

DRRC 

18 

23 

3 

DRC 

19 

22 

2 

RJC 

20 

21 

3 

ITRC 

IEPE 
I  WLS1 
!  WLS2 
iSBS 
I  Pi 
iCRL 
iTR8 
ITR7 
i  TR6 

TR5 

TR4 

TR3 
!  TR2 
i  TRi 

TRO 

TRE 

1  ThrT 

THRE 
MR 


PIN  CONNECTIONS 


n  A  A  A  A  A  h  Ji 


RECEIVER  HOLDING 

REGISTER 


TT 

Rl  » 

RECEIVER  REGISTER 

RECEIVER 
TIMING  AND 
CONTROL 


vccitlYi^ 

VSStGNOy 


CONTROL 
REGISTER 


CON 

crta 

2 


TRANSMITTER 

HOLDING 
REGISTER 


TRANSMITTER 
REGISTER 


TRANSMITTER 
TIMING  AND 
CONTROL 


-TRC 
-THRE 


TR1863nTR1865  BLOCK  DIAGRAM 
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GENERAL  DESCRIPTION 

The  Universal  Asynchronous  Receiver/Transmitter 
(UART)  is  a  general  purpose,  programmable  or 
hardwired  MOS/LSI  device  The  UART  is  used  to 
convert  parallel  data  to  a  serial  data  format  on  the 
transmit  side,  and  converts  a  serial  data  format  to 
parallel  data  on  the  receive  side 
The  serial  format  in  order  of  transmission  and 
reception  is  a  start  bit,  followed  by  five  to  eight  data 
bits,  a  parity  bit  (if  selected)  and  one,  one  and  one- 
half,  or  two  stop  bits. 

Three  types  of  error  conditions  are  available  on  each 
received  character  parity  error,  framing  error  (no  valid 
stop  bit)  and  overrun  error 


The  transmitter  and  receiver  operate  on  external  16X 
clocks,  where  16  clock  times  are  equal  to  one  bit 
time..  The  receiver  clock  is  also  used  to  sample  in  the 
center  of  the  serial  data  bits  to  allow  for  line 
distortion. 

Both  transmitter  and  receiver  are  double  buffered 
allowing  a  one  character  time  maximum  between  a 
data  read  or  write,  Independent  handshake  lines  for 
receiver  and  transmitter  are  also  included,  All  inputs 
and  outputs  are  TTL  compatible  with  three-state 
outputs  available  on  the  receiver,  and  error  flags  for 
bussing  multiple  devices 


PIN  DEFINITIONS 


PIN 
NUMBER 


NAME 


SYMBOL 


FUNCTION 


5-12 


13 


POWER  SUPPLY 

NC 

GROUND 

RECEIVER  REGISTER 

DISCONNECT 


RECEIVER  HOLDING 
REGISTER  DATA 


PARITY  ERROR 


VCC 
NC 
VSS 
RRD 


RR8- 
RR1 


PE 


FRAMING  ERROR 


FE 


+  5  volts  supply 

No  Internal  Connection 

Ground  =  OV 

A  high  level  input  voltage,  Vjh,  applied  to  this 

line    disconnects    the    RECEIVER    HOLDING 

REGISTER  outputs  from  the  RR^s  data  outputs 

(pins  5-12), 

The  parallel  contents  of  the  RECEIVER 
HOLDING  REGISTER  appear  on  these  lines  if  a 
low-level  input  voltage,  V|i_,  is  applied  to  RRD 
For  character  formats  of  fewer  than  eight  bits 
received  characters  are  right-justified  with  RR1 
(pin  12)  as  the  least  significant  bit  and  the 
truncated  bits  are  forced  to  a  low  level  output 
voltage,  Vol 

A  high  level  output  voltage,  VoH.  on  this  line 
indicates  that  the  received  parity  differ  from 
that  which  is  programmed  by  the  EVEN  PARITY 
ENABLE  control  line  (pin  39),  This  output  is 
updated  each  time  a  character  is  transferred 
to  the  RECEIVER  HOLDING  REGISTER,  PE 
lines  from  a  number  of  arrays  can  be  bussed 
together  since  an  output  disconnect  capability 
is  provided  by  Status  Flag  Disconnect  line 
(pin  16). 

A  high-level  output  voltage,  VoH.  on  this  line 
indicates  that  the  received  character  has  no 
valid  stop  bit,  i.e.,  the  bit  (if  programmed)  is  not 
a  high  level  voltage,  This  output  is  updated  each 
time  a  character  is  transferred  to  the  Receiver 
Holding  Register,  FE  lines  from  a  number  of 
arrays  can  be  bussed  together  since  an  output 
disconnect  capability  is  provided  by  the  Status 
Flag  Disconnect  line  (pin  16). 
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PIN  DEFINITIONS 


PIN 

NUMBER 

NAME 

SYMBOL 

FUNCTION 

15 

OVERRUN  ERROR 

OE 

A  high-level  output  voltage,  Voh.  on  this  line 
indicates  that  the  Data  Received  Flag  (pin  19) 
was  not  reset  before  the  next  character  was 
transferred  to  the  Receiver  Holding  Register. 
OE  lines  from  a  number  of  arrays  can  be  bussed 
together  since  an  output  disconnect  capability 
is  provided  by  the  Status  Flag  Disconnect  tine 
(pin  16). 

16 

STATUS  FLAGS 

SFD 

A  higrvlevel  input  voltage,  Vjh,  applied  to  this 

DISCONNECT 

pin  disconnects  the  PE,  FE,  OE,  DR  and  THRE 
allowing  them  to  be  buss  connected. 

17 

RECEIVER  REGISTER 

RRC 

The  receiver  clock  frequency  is  sixteen  (16) 

CLOCK 

times  the  desired  receiver  shift  rate 

Unn 

A  low-level  input  voltage,  v'n_,  applied  to  this 

RESET 

line  resets  the  DR  line 

19 

DATA  RECEIVED 

DR 

A  high-level  output  voltage,  Voh,  indicates  that 
an  entire  character   has  been   received  and 
transferred     to     the     RECEIVER     HOLDING 
REGISTER 

20 

RECEIVER  INPUT 

Rl 

Serial  input  data  A  high-level  input  voltage,  Vm, 
must   be   present   when  data   is   not   being 
received 

21 

MASTER  RESET 

MR 

This  line  is  strobed  to  a  high-level  input  voltage, 
V|h,  to  clear  the  logic.  It  resets  the  TRANS- 
MITTER   and    RECEIVER    HOLDING    REGIS- 
TERS, the  TRANSMITTER  REGISTER,  FE,  OE, 
PE,  DR  and  sets  TRO,  THRE,  and  TRE  to  a 
high-level  output  voltage,  Voh  - 

22 

TRANSMITTER 

THRE 

A  high-level  output  voltage,  VoHt  on  this  line 

HOLDING  REGISTER 

indicates  the  TRANSMITTER  HOLDING  REGIS- 

EMPTY 

TER    has    transferred    its    contents    to    the 
TRANSMITTER  REGISTER  and  may  be  loaded 
with  a  new  character, 

23 

TRANSMITTER 

TIHRL 

A  low-level  input  voltage,  Vjl,  applied  to  this 

HOLDING  REGISTER 

line  enters  a  character  into  the  TRANSMITTER 

LOAD 

HOLDING  REGISTER,  A  transition  from  a  low- 
level  input  voltage,  Vjl,  to  a  high-level  input 
voltage,  V|h,  transfers  the  character  into  the 
TRANSMITTER  REGISTER  if  it  is  not  in  the 
process    of    transmitting   a    character.    If   a 
character  is  being  transmitted,  the  transfer  is 
delayed  until  its  transmission  is  completed, 
Upon    completion,    the    new    character    is 
automatically  transferred  simultaneously  with 
the  initiation  of  the  serial  transmission  of  the 
new  character 

24 

TRANSMITTER 

TRE 

A  high-level  output  voltage,  Voh.  °n  this  line 

REGISTER  EMPTY 

indicates  that  the  TRANSMITTER  REGISTER 
has  completed  serial  transmission  of  a  full 
character  including  STOP  bit(s).  It  remains  at 
this  level  until  the  start  of  transmission  of  the 
next  character 

CO 

oi 
w 

H 
33 

00 
Oi 
OI 
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PIN  DEFINITIONS 


H 
3D 

00 

o> 

00 
OD 

en 


PIN 
NUMBER 


25 


TRANSMITTER 
REGISTER  OUTPUT 


TRANSMITTER 
REGISTER  DATA 
INPUTS 


CONTROL  REGISTER 
LOAD 


TRO 


PARITY  INHIBIT  PI 


TRvTRs 


CRL 


36 


37-38 


39 


40 


STOP  BIT(S)  SELECT 


WORD  LENGTH 
SELECT 


EVEN  PARITY 
ENABLE 


TRANSMITTER 
REGISTER 


SBS 


WLS2-WLS1 


EPE 


TRC 


FUNCTION 


The  contents  of  the  TRANSMITTER  REGISTER 
(START  bit,  DATA  bits,  PARITY  bit,  and  STOP 
bits)  are  serially  shifted  out  on  this  line,  When 
no  data  is  being  transmitted,  this  line  will 
remain  at  a  high-level  output  voltage,  VoH-  Start 
of  transmission  is  defined  as  the  transition  of 
the  START  bit  from  a  high-level  output  voltage 
Voh,  to  a  low-level  output  voltage  Vol 
The  character  to  be  transmitted  is  loaded  into 
the  TRANSMITTER  HOLDING  REGISTER  on 
these  lines  with  the  THRL  Strobe.  If  a  character 
of  less  than  8  bits  has  been  selected  {by  WLS1 
and  WLS2),  the  character  is  right  justified  to  the 
least  significant  bit,  TRt,  and  the  excess  bits 
are  disregarded,  A  high-level  input  voltage,  Vih, 
will  cause  a  high-level  output  voitage,  Voh,  to 
be  transmitted., 

A  high-level  input  voitage,  Vjh,  on  this  tine 
loads  the  CONTROL  REGISTER  with  the 
control  bits  (WLS1,  WL$2,  EPE,  PI,  SBS),  This 
line  may  be  strobed  or  hard  wired  to  a  high-level 
input  voltage,  Vih 

A  high-level  input  voltage,  V|H,  on  this  line 
inhibits  the  parity  generation  and  verification 
circuits  and  will  clamp  the  PE  output  (pin  13)  to 
Vol  It  parity  is  inhibited,  the  STOP  bit{s)  will 
immediately  follow  the  last  data  bit  of  trans- 
mission 

This  line  selects  the  number  of  STOP  bits  to  be 
transmitted  after  the  parity  bit.  A  high-level 
input  voltage  Vih,  on  this  line  selects  two  STOP 
bits,  and  a  low-level  input  voitage,  Vil,  selects  a 
single  STOP  bit  The  TR1863  and  TR1865 
generate  11/2  stop  bits  when  word  length  is  5 
bits  and  SBS  is  High  Vih 
These  two  lines  select  the  character  length 
(exclusive  of  parity)  as  follows: 

WLS2  WLS1  Word  Length 

VlL  Vil  5  bits 

ViL  Vjh  6  bits 

VIH  V|L  7  bits 

V|H  Vih  8  bits 

This  line  determines  whether  even  or  odd 
PARITY  is  to  be  generated  by  the  transmitter 
and  checked  by  the  receiver,  A  high-level  input 
voitage,  Vjh,  selects  even  PARITY  and  a  low- 
level  input  voitage,  Vil,  selects  odd  PARITY 
The  transmitter  clock  frequency  is  sixteen  (16) 
times  the  desired  transmitter  shift  rate 
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u 


15CL0CK  TIMES 
AFTER  START  OF 
LAST  STOP  BIT       (1) 


_^       (^ 


dl 


~®H      L*-   V:  CLOCK 


.  END  OF  LAST  STOP 
BIT  (COUNT  16) 


(1)  NOT  VALID  FOR  5.0  MHZ  OPTION 


CR1  CR2  CR3  CR4  CR5 


CASE  I < 


CASE  II  < 


IF  THE  POSITIVE  TRANSITION  OF 
THRL  OCCURS  >250ns  PRIOR  TO  ANY 
CLOCK  FALLING  EDGE  <CF3  IN 
SAMPLE)  THE  A,  B.  C,  AND  D  SIGNALS 
WILL  BE  GENERATED  AS  SHOWN  IN 
DETAIL  II 

IF  THE  POSITIVE  TRANSITION  OF 
THRL  OCCURS  £250ns  PRIOR  TO  ANY 
CLOCK  FALLING  EDGE  (CF3  IN 
SAMPLE)  THE  B  C,  AND  D  SIGNALS 
MAY  BE  GENERATED  ON  THE  FOL 
LOWING  CLOCK  TIME  IE.  THE  B.  C. 
AND  D  SIGNALS  AS  SHOWN  IN 
DETAIL  MAY  CHANGE  AS    FOLLOWS: 

CF3TOCF4 

CF4TOCF5 

CR4TOCR5 


NOTE:  IT  IS  ADVISABLE  TO  CONSIDER 
CASE  !l  FOR  fcLOCK  >  '»  °  MHZ 


TRANSMITTER  TIMING 
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2 

CO 

en 
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00 

2 

00 
Oi 


START  (1)  STOP  START 


RR1-RR8  AND  ERROR  FLAGS  RE,  FE,  OE(5) 


T_ 


DETAIL: 

1  2  3         4  5  6         7 


U 


10       11         12        13        14        15        0 


=^^¥^ruuu^^jw 


vyA 


STOP  BIT 

TRANSITION 


I  NOMINAL  BIT  CENTER 

I* 


PE,  FE(3) 


I     I 


RR1-RR8,  OE(3) 

-M 


I 


H 


II- 


(1}  SEE  APPLICATION  FLAGS  REPORT  NO  1  FOR  DESCRIP- 
TION OF  START  BIT  DETECTION 

(2)  THE  DELAY  BETWEEN  DRR  AND  DR  =  Id  -  500  NS 

(3)  DR  ERROR  FLAGS,  AND  DATA  ARE  VALID  AT  THE 
NOMINAL  CENTER  OF  THE  FIRST  STOP  BIT 

(4)  DRR  SHOULD  BE  HIGH  A  MINIMUM  OF  "A"  NS  {ONE- 
HALF  CLOCK  TIME  PLUS  tpd)  PRIOR  TO  THE  RISING 
EDGE  OF  DR 

(5)  DATA  AND  OE  PRECEDES  DR,  PE,  AND  FE  FLAGS  BY 
V;  CLOCK 

(6)  DATA  FLAGS  WILL  REMAIN  SET  UNTIL  A  GOOD  CHARAC 
TER  IS  RECEIVED  OR  MASTER  RESET  IS  APPLIED 

RECEIVER  TIMING 
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DATA  INPUT  LOAD  CYCLE 


CONTROL  REGISTER  LOAD  CYCLE 


■*-tpdi*l 


•PE,FEvOEtDR,THRE 


•OUTPUTS  PE,  FE,  OE,  DR,  THHE  ARE  DIS- 
CONNECTED ATTRANSITION  OF SFD 
FROM  0  8V  TO  2.0V. 


X 


0.8  V 


■*-tpdi-H 


\  /T  20V 


«*~tpdO-**| 


•RR1-RR3,  ARE  DISCONNECTED  AT 
TRANSITION  OF  RRD  FROM  0  8V  TO  2.0V 


STATUS  FLAG  OUTPUT  DELAYS 


DATA  OUTPUT  DELAYS 
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ENABLE  FEF/F 
TO  BE  SET 
TOVqh 


ENABLE  FERF 

TO  BE  RESET 

TO  Vol 


ENABLE  OEF/F 
TO  BE  SET 
TOVoH 


ENABLEOEF(F 

TO  BE  RESET 

TO  Vol 


TRANSFER  DATA  BITS  FROM 

RECEIVER  REGISTER  TO 

RECESVER  HOLDiNG  REGISTER 

AND  SET OE TO 

PROPER  STATE 


SET  OR  PE  &  FE  FLAGS  TO  PROPER  STATES 


DR  =  V0H 


operator\ 

ACTION        / 


EXAMINE  OUTPUTS 
1    STROBE SFO 
2.  STROBE  RRD 


DRR  =  Vql. 

dr— Vol 
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ABSOLUTE  MAXIMUM  RATINGS 

NOTE:  These  voltages  are  measured  with  respect  to  GND 

Storage  Temperature 

Plastic ~~55°Cto  +  125°C 

Ceramic -65°C  to  +  150°C 

Vcc  Supply  Voltage   -0.3V  to  +  7  0V 

Input  Voltage  at  any  pin  ,  . -0.3V  to  -f  7  0V 

Operating  Free-AirTemperature 
Ta  Range 0°C  to 70°C 

Lead  Temperature  (Soldering,  10  sec.)  300°C 


ELECTRICAL  CHARACTERISTICS 

(VCC  =  5V±5%tVss=:0V) 


SYMBOL 

PARAMETER 

TR1863/5 

OPERATING  CURRENT 

MIN 

MAX 

CONDITIONS 

ice 

Supply  Current 
LOGIC  LEVELS 

35  ma 

Vcc  =  5.25V 

V|H 
VlL 

Logic  High 
Logic  Low 
OUTPUT  LOGIC  LEVELS 

2.4V 

0,6V 

Vcc  =  475V 

VOH 

vol 
be 

"IL 
llH 

Logic  High 
Logic  Low 
Output  Leakage 
(High  Impedance  State) 
Low  Level  Input  Current 

High  Level  Input  Current 

2.4V 

100^a 

0.4V 

±10^a 

1.6rna 
1tya 

-10^a 

Vcc  =  4,75V,  Ioh  =  100>a 
Vcc  =  5.25V,  loL  =  1.6  ma 
VOUT  =  OV,V0UT  =  5V 
SFD=  RRD  =  ViH 
Vjn  =  04V  TR  1865  only 
VjN  =  V|L,TR  1863  only 
V|N  =  Vjh,TR  1863  only 
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SWITCHING  CHARACTERISTICS 
(See  "Switching  Waveforms") 


SYMBOL 

PARAMETER 

MIN 

MAX 

CONDITIONS 

fclock 

Clock  Frequency 

VCC  =  475V 

TR1 863-00 

DC 

1.0  MHz 

TR1 863-02 

DC 

2,5  MHz 

TR1 863-04 

DC 

3,5  MHz 

TR1 863-06 

DC 

5,0  MHz 

TR1 865-00 

DC 

1.0  MHz 

with  internal  pull-ups  on  all  inputs 

TR1 865-02 

DC 

Z5MHz 

with  internal  pull-ups  on  all  inputs 

TR1 865-04 

DC 

3.5  MHz 

with  internal  pull-ups  on  alt  inputs 

TR1 865-06 

DC 

5.0  MHz 

with  internal  pull-ups  on  all  inputs 

tpw 

Pulse  Widths 

GRL 

THRL 

DRR 

MR 

200  lib 
200  ns 
200  ns 
500  ns 

tc 

Coincidence  Time 

200  ns 

thold 

Hoid  Time 

20  ns 

tset 

Set  Time 

OUTPUT  PROPAGATION 

DELAYS 

0 

tpdO 

To  Low  State 

250  ns 

tpdl 

To  High  State 
CAPACITANCE 

250  ns 

Cl  =  20  pf,  plus  one  TTL  load 

Cjn 

Inputs 

20  pf 

f  =  1  MHz,V|N  -  5V 

Co 

Outputs 

20  pf 

f  =  1MHz,V[N  =  5V 

00 
CJ5 
CO 


CO 

en 

oi 


See  page  725  for  ordering  information 
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Information  furnished  by  Western  Digital  Corporation  ts  believed  to  be  accurate  and  reliable  Howevef  no  responsibility  is  assumed  by  Western  Digital 
Corporation  (or  its  use,  nor  for  any  infringements  o(  patents  or  other  rights  ot  third  parties  which  may  result  from  its  use  No  license  is  granted  b^ 
amplication  or  otherwise  under  any  patent  or  patent  rights  of  Western  Digital  Corporation  Western  Digital  Corporation  reserves  the  right  to  change 
specifications  af  anytime  without  notice 
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1/Disk  Organization 


TRSDOS  Version  6  can  be  used  with  SW  single-sided  floppy  diskettes  and 
with  hard  disk„  Floppy  diskettes  can  be  either  single- or  double-density.  See  the 
charts  below  for  the  number  of  sectors  per  track,  number  of  cylinders,  and  so 
on  for  each  type  of  disk.  {Sectors  and  cylinders  are  numbered  starting  with  0) 


Single-Density  Floppy  Diskette 


Bytes       Sectors      Sectors      Granules       Tracks       Cylinders 

per           per            per             per              per              per  Total 

Sector     Granule       Track*          Track        Cylinder         Drive  Bytes 

256         256 

5             1,280 

(1 0)                2              2,560 

1             2,560 

40  102,400 

256              5               (10)                2                   1                   40  102,400 

(100Kr 


Double-Density  Floppy  Diskette 


Bytes       Sectors      Sectors      Granules       Tracks       Cylinders 
per  per  per  per  per  per  Total 

Sector     Granule       Track*  Track        Cylinder         Drive  Bytes 

256        256 

6             1,536 

(18)                3              4,608 

1             4,608 

40  184,320 

256              6               (18)                3                    1                   40  184,320 

(180K)** 

*The  number  of  sectors  per  track  is  not  included  in  the  calculation  because  it 
is  equal  to  the  number  of  sectors  per  granule  times  the  number  of  granules 
per  track.  (5x2  =  10  for  single  density,  6  x  3  ~  18  for  double  density,  and 
16x2  =  32  for  hard  disk) 

**Note  that  this  figure  is  the  total  amount  of  space  in  the  given  format,  Keep  in 
mind  that  an  entire  cylinder  is  used  for  the  directory  and  at  least  one  granule 
is  used  for  the  bootstrap  code.  This  leaves  96.25K  available  for  use  on  a 
single-density  data  disk  and  174K  on  a  double-density  data  disk, 
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5"  5-Meg  Hard  Disk 


Note:  Because  of  continual  advancements  in  hard  disk  technology,  the  number 
of  tracks  and  the  number  of  tracks  per  cylinder  may  change,  Therfbre,  any  infor- 
mation that  comes  with  your  hard  disk  drive(s)  supersedes  the  information  in 
the  table  below. 

Bytes      Sectors     Sectors     Granules      Tracks      Cylinders 
per  per  per  per  per  per  Total 

Sector     Granule      Track*         Track        Cylinder        Drive  Bytes 

256        256 

16         4,096 

(32)              2            8,192 

4           32,768 

153  5,013,504 

256            16             (32)              2                 4               153  5,013,504 

(4.896K) 

The  number  of  sectors  per  track  is  not  included  in  the  calculation  because  it  is 
equal  to  the  number  of  sectors  per  granule  times  the  number  of  granules  per 
track.  (5x2  =  10  for  single  density,  6x3  =  18  for  double  density,  and 
16x2  =  32  for  hard  disk) 


Disk  Space  Available  to  the  User 


One  granule  on  cylinder  0  of  each  disk  is  reserved  for  the  system.  It  contains 
information  about  where  the  directory  is  located  on  that  disk,  if  the  disk  contains 
an  operating  system,  then  all  of  cylinder  0  is  reserved.  This  area  contains  infor- 
mation used  to  load  TRSDOS  when  you  press  the  reset  button. 

One  complete  cylinder  is  reserved  for  the  directory,  the  granule  allocation  table 
(GAT),  and  the  hash  index  table  (HIT).  (On  single-sided  diskettes,  one  cylinder 
is  the  same  as  one  track,)  The  number  of  this  cylinder  varies,  depending  on  the 
size  and  type  of  disk.  Also,  if  any  portion  of  the  cylinder  normally  used  for  the 
directory  is  flawed,  TRSDOS  uses  another  cylinder  for  the  directory.  You  can 
find  out  where  the  FORMAT  utility  has  placed  the  directory  by  using  the 
Free  :drive  command. 

On  hard  disks,  an  additional  cylinder  (cylinder  1 )  is  reserved  for  use  in  case 
your  disk  drive  requires  service.  This  provides  an  area  for  the  technician  to  write 
on  the  disk  without  harming  any  data.  (If  you  bring  your  hard  disk  in  for  service, 
you  should  try  to  back  up  the  contents  of  the  disk  first,  just  to  be  safe.) 


Unit  of  Allocation 


The  smallest  unit  of  disk  space  that  the  system  can  allocate  to  a  file  is  a  gran- 
ule. A  granule  is  made  up  of  a  set  of  sectors  that  are  adjacent  to  one  another 
on  the  disk.  The  number  of  sectors  in  a  granule  depends  on  the  type  and  size 
of  the  disk,  See  the  charts  on  the  previous  two  pages  for  some  typical  sizes. 
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2/Disk  Files 


Methods  of  File  Allocation 


Record  Length 


TRSDOS  provides  two  ways  to  allocate  disk  space  for  files:  dynamic  allocation 
and  pre-al location., 

Dynamic  Allocation 

With  dynamic  allocation,  TRSDOS  allocates  granules  only  at  the  time  of  write. 
For  example/when  a  file  is  first  opened  for  output,  no  space  is  allocated,,  The 
first  allocation  of  space  is  done  at  the  first  write.  Additional  space  is  added  as 
required  by  further  writes. 

With  dynamically  allocated  files,  unused  granules  are  de-allocated  (recovered) 
when  the  file  is  closed 

Unless  you  execute  the  CREATE  system  command,  TRSDOS  uses  dynamic 
allocation, 

Pre-Allocation 

With  pre-allocation,  the  file  is  allocated  a  specified  number  of  granules  when  it 
is  created.,  Pre-aliocated  files  can  be  created  only  by  the  system  command 
CREATE.  (See  the  Disk  System  Owner's  Manual  for  more  information  on 
CREATE,) 

TRSDOS  automatically  extends  a  pre-allocated  file  as  needed.  However,  it 
does  not  de-allocate  unused  granules  when  a  pre-allocated  file  is  closed.  To 
reduce  the  size  of  a  pre-allocated  file,  you  must  copy  it  to  a  dynamically  allo- 
cated file.  The  COPY  (CLONE  =  N)  system  command  does  this  automatically. 

Files  that  have  been  pre-allocated  have  a  'C  by  their  names  in  a  directory 
listing. 


TRSDOS  transfers  data  to  and  from  disks  one  sector  at  a  time.  These  sectors 
are  256-byte  blocks,  and  are  also  called  the  system's  "physical"  records. 

You  deal  with  records  that  are  256  bytes  in  length  or  smaller,  depending  on 
what  size  record  you  want  to  work  with.  These  are  known  as  "logical"  records. 

You  set  the  size  of  the  logical  records  in  a  file  when  you  open  the  file  for  the  first 
time.  The  size  is  the  number  of  bytes  to  be  kept  in  each  record,,  There  may  be 
from  1  to  256  bytes  per  logical  record. 

The  operating  system  automatically  accumulates  your  logical  records  and 
stores  them  in  physical  records.  Since  physical  records  are  always  256  bytes  in 
length,  there  may  be  one  or  more  logical  records  stored  in  each  physical  record. 
When  the  records  are  read  back  from  disk,  the  system  automatically  returns 
one  logical  record  at  a  time,  These  actions  are  known  as  "blocking"  and  "de- 
blocking," or  "spanning" 

For  example,  if  the  logical  record  length  is  200,  sectors  1  and  2  look  like  this: 
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S£CTOB 


ONE 


^O* 


Since  they  are  completely  handled  by  the  operating  system,  you  do  not  need  to 
concern  yourself  with  physical  records,  sectors,  granules,  tracks,  and  so  on. 
This  is  to  your  benefit,  as  the  number  of  sectors  per  granule  varies  from  disk  to 
disk,  Also,  physical  record  lengths  may  change  in  future  versions  of  TRSDOS, 
but  the  concept  of  logical  records  will  not,. 
Note:  All  files  are  fixed-length  record  files  with  TRSDOS  Version  6,. 


Record  Processing  Capabilities 


TRSDOS  allows  both  direct  and  sequential  file  access. 

Direct  access  (sometimes  called  "random  access")  lets  you  process  records  in 

any  sequence  you  specify. 

Sequential  access  allows  you  to  process  records  in  sequence:  record  n,  n  +  1, 
n  +  2,  and  so  on.  With  sequential  access,  you  do  not  specify  a  record  number. 
Instead,  TRSDOS  accesses  the  record  that  follows  the  last  record  processed, 
starting  with  record  0. 

With  sequential  access  files,  use  the  @READ  supervisor  call  to  read  the  next 
record,  and  the  ©WRITE  or  @VER  supervisor  call  to  write  the  next  record. 
(When  the  file  is  first  opened,  processing  starts  at  record  0.  You  can  use 
@PEOF  to  position  to  the  end  of  file.) 

To  read  or  write  to  a  direct  access  file,  use  the  @POSN  supervisor  call  to  posi- 
tion to  a  specified  record.  Then  use  @READ,  @WRITE,  or  @VER  as  desired. 
Once  @POSN  has  been  used,  the  End  of  File  (EOF)  marker  will  not  move, 
unless  the  file  is  extended  by  writing  past  the  current  EOF  position. 

Record  Numbers 

Using  direct  (random)  access,  you  can  access  up  to  65,536  records.  Record 
numbers  start  at  0  and  go  to  65535. 

Using  a  file  sequentially,  you  can  access  up  to  16,777,216  bytes.  To  calculate 
the  number  of  records  you  can  access  sequentially,  use  the  formula: 

16,777,216  -*■  logical  record  length  -  number  of  sequential 

records  allowed 
Below  are  some  examples,. 


IftheLRL- 256,  then: 

16,777,216 


256  =  65,536  records 


If  the  LRL=  128,  then: 

16,777,216  ■*-  128  =  131 ,072  records 


SftheLRL-   50,  then: 

16,777,216  ■ 


50=335,544  records 


lftheLRL=     1,then: 

1 6,777,21 6  +       1  =  1 6,777,21 6  records 
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3/TRSDOS  File  Descriptions 


This  section  describes  four  types  of  files  found  on  your  TRSDOS  master  disk- 
ette (system  files,  utilities,  driver  programs,  and  filter  programs)  and  explains 
their  functions,  It  also  describes  how  to  construct  a  minimum  system  disk  for 
running  applications  packages. 


System  Files  (/SYS) 


TRSDOS  Version  6  would  occupy  considerable  memory  space  if  all  of  it  were 
resident  in  memory  at  any  one  time.  To  minimize  the  amount  of  memory 
reserved  for  system  use,  TRSDOS  uses  overlays. 

Using  an  overlay-driven  system  involves  some  compromise-  While  a  user's 
application  is  in  progress,  different  overlays  may  need  to  be  loaded  to  perform 
certain  activities  requested  of  the  system.  This  could  cause  the  system  to  run 
slightly  slower  than  a  system  which  has  more  of  its  file  access  routines  always 
resident  in  memory 

The  use  of  overlays  also  requires  that  a  SYSTEM  disk  usually  be  available  in 
Drive  0  (the  system  drive).,  Since  the  disk  containing  the  operating  system  and 
its  utilities  leaves  little  space  available  to  the  user,  you  may  want  to  remove  cer- 
tain parts  of  the  system  software  not  needed  while  a  particular  application  is 
running,  You  may  in  fact  discover  that  your  day-to-day  operations  need  only  a 
minimal  TRSDOS  configuration.  The  greater  the  number  of  system  functions 
unnecessary  for  your  application,  the  more  space  you  can  have  available  for  a 
"working"  system  disk.  Use  the  PURGE  or  REMOVE  library  command  to  elim- 
inate unneeded  system  files  from  the  disk, 

The  following  paragraphs  describe  the  functions  performed  by  each  system 
overlay,  {In  the  display  produced  by  the  DIR  (SYS)  library  command,  the  system 
overlays  are  identified  by  the  file  extension  /SYS) 

Note:  Two  system  files  are  put  on  the  disk  during  formatting.  They  are  DIR/SYS 
and  BOOT/SYS,  These  files  should  never  be  copied  from  one  disk  to  another 
or  REMOVEd,  TRSDOS  automatically  updates  any  information  necessary 
when  performing  a  backup, 

SYS0/SYS 

This  is  not  an  overlay  It  contains  the  resident  part  of  the  operating  system 
(SYSRES),  !t  is  also  needed  to  dynamically  allocate  file  space  used  when  writ- 
ing files.  Any  disk  used  for  booting  the  system  must  contain  SYS0,  It  can  be 
purged  from  disks  not  used  for  booting 

SYS1/SYS 

This  overlay  contains  the  TRSDOS  command  interpreter  and  the  routines  for 
processing  the  @CMNDI,  @CMNDR,  @FEXT,  @FSPEC,  and  @PARAM  sys- 
tem vectors.  This  overlay  must  be  available  on  alt  SYSTEM  disks, 

SYS2/SYS 

This  overlay  is  used  for  opening  or  initializing  disk  files  and  logical  devices,  it 
also  contains  routines  for  processing  the  @CKDRV,  @GTDCB,  and  @  REN  AM 
system  vectors,  and  routines  for  hashing  file  specifications  and  passwords 
This  overlay  must  be  available  on  ail  SYSTEM  disks, 

SYS3/SYS 

This  overlay  contains  all  of  the  system  routines  needed  to  close  files  and  logical 
devices.  It  also  contains  the  routines  needed  to  service  the  @FNAME  system 
vector  This  overlay  must  not  be  removed  from  the  disk. 
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SYS4/SYS 

This  overlay  contains  the  system  error  dictionary.  It  is  needed  to  issue  such 
messages  as  "rile  not  found,"  "Directory  read  error,"  etc.  If  you  decide  to 
remove  this  overlay  from  your  working  SYSTEM  disk,  all  system  errors  will  pro- 
duce the  error  message  "SYS  ERROR!'  It  is  recommended  that  you  not  remove 
this  overlay,  especially  since  it  occupies  only  one  granule  of  space. 

SYS5/SYS 

This  is  the  "ghost"  debugger,  It  is  needed  if  you  intend  to  test  out  machine  lan- 
guage application  software  by  using  the  TRSDOS  DEBUG  library  command.  If 
your  operation  will  not  require  this  debugging  tool,  you  may  purge  this  overlay. 

SYS6/SYS 

This  overlay  contains  ail  of  the  routines  necessary  to  service  the  library  com- 
mands identified  as  "Library  A"  by  the  LIB  command.  This  represents  the  pri- 
mary library  functions,  Only  very  limited  use  can  be  made  of  TRSDOS  if  this 
overlay  is  removed  from  your  working  SYSTEM  disk. 

SYS7/SYS 

This  overlay  contains  ail  of  the  routines  necessary  to  service  the  library  com- 
mands identified  as  "Library  B"  by  the  LIB  command.  A  great  deal  of  use  can 
be  made  of  TRSDOS  even  without  this  overlay  It  performs  sneciali7erl  func- 
tions that  may  not  be  needed  in  the  operation  of  specific  applications.  You  can 
purge  this  overlay  if  you  decide  it  is  not  needed  on  a  working  SYSTEM  disk,. 

SYS8/SYS 

This  overlay  contains  ali  of  the  routines  necessary  to  service  the  library  com- 
mands identified  as  "Library  C"  by  the  LIB  command,  A  great  deal  of  use  can 
be  made  of  TRSDOS  even  without  this  overlay  It  performs  specialized  func- 
tions that  may  not  be  needed  in  the  operation  of  specific  applications.  You  can 
purge  this  overlay  if  you  decide  it  is  not  needed  on  a  working  SYSTEM  disk. 

SYS9/SYS 

This  overlay  contains  the  routines  necessary  to  service  the  extended  DEBUG 
commands  available  after  a  DEBUG  (EXT)  is  performed.  This  overlay  may  be 
purged  if  you  will  not  need  the  extended  DEBUG  commands  while  running  your 
application.  If  you  remove  SYS5/SYS,  then  you  may  as  well  remove  SYS9/SYS, 
as  it  wouid  serve  no  useful  purpose, 

SYS10/SYS 

This  system  overlay  contains  the  procedures  necessary  to  service  the  request 
to  remove  a  file.  It  should  remain  on  your  working  SYSTEM  disks, 

SYS11/SYS 

This  overlay  contains  all  of  the  procedures  necessary  to  perform  the  Job  Con- 
trol Language  execution  phase.  You  may  remove  this  overlay  from  your  working 
disks  if  you  do  not  intend  to  execute  any  JCL  functions.  If  SYS6/SYS  (which 
contains  the  DO  command)  has  been  removed,  keeping  this  overlay  would 
serve  no  purpose, 

SYS12/SYS 

This  system  overlay  contains  the  routines  that  service  the  @DODlR, 
@GTMOD,  and  @RAMDIR  system  vectors.  It  should  remain  on  your  disks, 

SYS13/SYS 

This  overlay  is  reserved  for  future  system  use  It  contains  no  code  and  takes  up 
no  space  on  the  disk.  You  may  remove  this  overlay  if  you  wish  to  free  up  its 
directory  slot. 
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In  TRSDOS  Version  6  2,  this  overlay  contains  the  message  "No  ECI  is  present 
at  SYS13"  if  you  have  not  implemented  an  Extended  Command  Interpreter 
(ECI)  or  an  Immediate  Execution  Program  (IEP)  You  may  purge  this  overlay  if 
you  do  not  intend  to  use  an  ECI  or  an  IEP  See  Appendix  F,  Using  SYS13,  for 
more  information 


Utility  Programs 


BACKUP       —  Used  to  duplicate  data  from  one  disk  to  another. 

COMM  —A  communications  package  for  use  with  the  RS~232C 

hardware 

CONV  —  Used  to  copy  files  from  Model  ill  TRSDOS  to  TRSDOS  Version 

6. 

DOS/HLP      —  (Version  6  2  only)  The  data  file  used  with  the  HELP  utility 

FORMAT       —  Used  to  put  track,  sector,  and  directory  information  on  a  disk, 

HELP/CMD   —  (Version  6.2  only)  Used  to  provide  on-line  information  about 
the  TRSDOS  commands 

LOG  —  Used  to  log  in  a  double-sided  diskette  in  Drive  0,  Also  updates 

the  Drive  Code  Table  information  as  with  the  DEVICE  library 
command 

PATCH  —  Used  to  make  changes  to  existing  files,, 

REPAIR         —  Used  to  correct  certain  information  on  non-TRSDOS  format- 
ted diskettes 


TAPE  100       — 


A  disk/tape,  tape/disk  utility  for  cassette  tape  operations  with 
the  TRS-80  Model  100 


Device  Driver  Programs 


COM/DVR 
FLOPPY/DCT 


-  The  RS-232C  communications  driver 

-  Configures  floppy  drives  in  the  system.  Not  needed  with  a 
floppy-only  system,, 


Filter  Programs 


JL/DVR  —  The  Joblog  driver  program. 

MEMDISK/DCT  —  Used  to  establish  a  pseudo  floppy  drive  in  memory. 


CLICK/FLT        —  Produces  a  short  tone  as  each  key  is  pressed, 

FORMS/FLT      —  Used  to  select  printer  parameters  and  perform  character 
translation, 

KSM/FLT  —  The  Keystroke  Multiply  feature,  which  allows  the  assigning 

of  user-determined  phrases  to  alphabetic  keys. 


Creating  a  Minimum  Configuration  Disk 


All  files  except  certain  /SYS  files  may  be  purged  from  your  Drive  0  disk.  Addi- 
tionally if  you  place  the  needed  /SYS  files  in  high  memory  with  the  SYSTEM 
(SYSRES)  command,  it  will  be  possible  to  run  with  a  minimum  configuration 
disk  in  Drive  0  after  booting  the  system.  Keep  the  following  points  in  mind  when 
purging  system  files: 

•  For  operation,  SYS  files  1,  2,  3,  4, 10,  and  12  should  remain  on  the  Drive 
0  disk  or  be  resident  in  memory. 
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•  SYS2  must  be  on  the  system  disk  if  a  configuration  file  is  to  be  loaded,, 

•  SYS11  must  be  present  oniy  if  any  JCL  files  will  be  used. 

•  Ail  three  libraries  (SYS  files  6,  7,  and  8)  may  be  purged  if  no  library  com- 
mand will  be  used. 

•  SYS5  and  SYS9  may  be  purged  if  the  system  DEBUG  package  is  not 
needed. 

•  SYS0  may  be  removed  from  any  disk  not  used  for  booting, 

•  SYS11  (the  JCL  processor)  and  SYS6  (containing  the  DO  library  com- 
mand) must  both  be  on  the  disk  if  the  DO  command  is  to  be  used.  Also, 
if  you  remove  SYS6,  you  may  as  well  remove  SYS  11 

•  SYS13  may  be  removed  if  you  have  not  implemented  an  ECl,  an  SEP  file, 
or  if  you  do  not  intend  to  use  them 

The  presence  of  any  utility,  driver,  or  filter  program  is  dependent  upon  your  in- 
dividual needs.  You  can  save  most  of  the  TRSDOS  features  in  a  configuration 
file  using  the  SYSTEM  (SYSGEN)  command,  so  the  driver  and  filter  programs 
will  not  be  needed  in  run  time  applications.  If  you  intend  to  use  the  HELP  utility, 
your  disk  must  contain  the  DOS/HLP  file 
The  owner  (update)  passwords  for  TRSDOS  files  are  as  follows: 

File  Type  Extension  Owner  Password 


System  files  (/SYS)  LSIDOS 

Filter  files  {/FLT)  FILTER 

Driver  files  (/DVR)  DRIVER 

Utility  files  (/CMD)  UTILITY 

BASIC  BASIC 

BASIC  overlays  (/OV$)  BASIC 

CONFIG/SYS  CCC 

Drive  Code  Table  {/DCT)  UTILITY 
Initializer 
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4/Oevice  Access 


Device  Control  Block  (DCB) 


The  Device  Control  Block  (DCB)  is  an  area  of  memory  that  contains  informa- 
tion used  to  interface  the  operating  system  with  various  logical  devices.  These 
devices  include  the  keyboard  (*KI),  the  video  display  (*DO),  a  printer  (*PR),  a 
communications  line  (*CL),  and  other  devices  that  you  may  define. 

The  following  information  describes  each  assigned  DCB  byte, 

DCB  +  0  (TYPE  Byte) 

Bit  7™  If  set  to  "1"  the  Device  Control  Block  is  actually  a  File  Control  Block 
(FCB)  with  the  file  open.  Since  DCBs  and  FCBs  are  similar,  and 
devices  may  be  routed  to  files,  a  "device"  with  this  bit  set  indicates 
a  routing  to  a  file. 

Bit  6 — If  set  to  "1"  the  device  defined  by  the  DCB  is  filtered  or  is  a  device 
filter 

Bits  —  If  set  to  "1;?  the  device  defined  by  the  DCB  is  linked. 

Bit  4 —  If  set  to  "1"  the  device  defined  by  the  DCB  is  routed, 

Bit  3  —  If  set  to  "1,"  the  device  defined  by  the  DCB  is  a  NIL  device.  Any  out- 
put directed  to  the  device  is  discarded.,  For  any  input  request,  the 
character  returned  is  a  null  (ASCII  value  0). 

Bit  2— If  set  to  "1,"  the  device  defined  by  the  DCB  can  handle  requests 
generated  by  the  @CTL  supervisor  call.  See  the  section  on  Super- 
visor Calls  for  more  information. 

Bit  1  —If  set  to  "1,"  the  device  defined  by  the  DCB  can  handle  output 
requests  which  normally  come  from  the  @PUT  supervisor  call. 

Bit  0  —  If  set  to  "1,"  the  device  defined  by  the  DCB  can  handle  requests  for 
input  which  normally  come  from  the  @GET  supervisor  call. 

DCB+1 and DCB +2 

Contain  the  address  of  the  driver  routine  that  supports  the  hardware  assigned 
to  this  DCB.  (In  the  case  of  a  routed  or  linked  device,  the  vector  may  point  to 
another  DCB,) 

DCB  +  3  through  DCB  +  5 

Reserved  for  system  use. 

DCB  +  6and  DCB+7 

These  locations  normally  contain  the  two  alphabetic  characters  of  the  devspec, 
The  system  uses  the  devspec  as  a  reference  in  searching  the  device  control 
block  tables. 
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Memory  Header 


Modules  that  TRSDOS  loads  into  memory  (filters,  drivers,  and  other  memory 
modules  such  as  a  SPOOL  buffer  or  the  extended  DEBUG  code)  are  identified 
by  a  standard  front-end  header: 

BEGIN:   JR   START 
DEFW  END-1 

DEFB  10 


MODDCB: 


DEFM  'NAMESTRING' 


DEFW  $-$ 
DEFW  0 


iGo  to  actual  code 

(beginning 

^Contains  the  highest  byte 

5of  memory 

?used  by  the  module 

iLensth  of  name  *  1-15 

icharacte  rs  i 

*bits  4-7  reserved  for 

is v stem  use 

iUp  to  15  alphanumeric 

(Characters*  with  the  first 

(Character  A-Z.  This  should 

(be  a  unique  name  to 

(positively  identify  the 

Smodule ♦ 

iDCB  pointing  to  this 

imodule  (if  applicable) 

iSpare  system  pointer  „ 

(RESERVED 


Any  additional  data  storage  goes  here 
START:   Start  of  actual  program  code 

END:     EQU  $ 

As  explained  under  the  @GTMOD  SVC  in  the  "Supervisor  Call"  section,  the 
location  of  a  specific  header  can  be  found  provided  all  modules  that  are  put  into 
memory  use  this  header  structure.  You  can  locate  the  data  area  for  a  module 
by  using  @GTMOD  to  find  the  start  of  the  header  and  then  indexing  in  to  the 
data  area. 
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5/Drive  Access 


Drive  Code  Table  (DCT) 


TRSDOS  uses  a  Drive  Code  Table  (DCT)  to  interface  the  operating  system  with 
specific  disk  driver  routines.  Note  especially  the  fields  that  specify  the  allocation 
scheme  for  a  given  drive.  This  data  is  essential  in  the  allocation  and  accessi- 
bility of  file  records. 

The  DCT  contains  eight  10-byte  positions  —  one  for  each  logical  drive  des- 
ignated 0-7  TRSDOS  supports  a  standard  configuration  of  two-floppy 
drives.  You  may  have  up  to  four  floppy  drives,,  This  is  the  default  initializa- 
tion when  TRSDOS  is  loaded 

Here  is  the  Drive  Code  Table  layout: 

DCT  4-0 

This  is  the  first  byte  of  a  3-byte  vector  to  the  disk  I/O  driver  routines,  This  byte 
is  normally  X'C3.'  If  the  drive  is  disabled  or  has  not  been  configured  (see  the 
SYSTEM  command  in  the  Disk  System  Owner's  Manual),  this  byte  is  a  RET 
instruction  (X'C9')., 

DCT+1 and DCT +2 

Contain  the  entry  address  of  the  routines  that  drive  the  physical  hardware. 

DCT +  3 

Contains  a  series  of  flags  for  drive  specifications, 

Bit  7™  Set  to  "1"  if  the  drive  is  software  write  protected,  "0"  if  it  is  not  (See 
the  SYSTEM  command  in  the  Disk  System  Owner's  Manual.) 

Bit  6  — Set  to  "1"  for  DDEN  (double  density),  or  "0"  for  SDEN  (single 
density) , 

Bit  5  — Set  to  "1"  if  the  drive  is  an  8"  drive,  Set  to  "0"  if  it  is  a  SW  drive- 
Bit  4— A  "1"  causes  the  selection  of  the  disk's  second  side.  The  first  side 
is  selected  if  this  bit  is  "0"  This  bit  value  matches  the  side  indicator 
bit  in  the  sector  header  written  by  the  Floppy  Disk  Controller 
(FDC). 

Bit  3— A  "1"  indicates  a  hard  drive  (Winchester).,  A  "0"  denotes  a  floppy 
drive  (5VV  or  8"). 

Bit  2— Indicates  the  time  delay  between  selection  of  a  5VV'  drive  and  the 
first  poll  of  the  status  register.  A  "1"  value  indicates  0,5  second  and 
a  "0"  indicates  10  second.  See  the  SYSTEM  command  in  the  Disk 
System  Owner's  Manual  for  more  details. 

If  the  drive  is  a  hard  drive,  this  bit  indicates  either  a  fixed  or  remov- 
able disk:  "1"  =  fixed,  "0"  -  removable 

Bits  1  and  0  —  Contain  the  step  rate  specification  for  the  Floppy  Disk  Con- 
troller (See  the  SYSTEM  command  in  the  Disk  System  Owner's 
Manual)  in  the  case  of  a  hard  drive,  this  field  may  indicate  the  drive 
address  (0-3). 

DCT +4 

Contains  additional  drive  specifications. 

Bit  7~~~~  (Version  6  2  only)  If  "1 M,  no  (aCKDRV  is  done  when  accessing  the 
drive  if  an  application  opens  several  files  on  a  drive,  this  bit  can  be 
set  to  speed  I/O  on  that  drive  after  the  first  successful  open  is 
performed, 
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In  versions  prior  to  TRSDOS  6.2,  this  bit  is  reserved  for  future  use 
In  order  to  maintain  compatibility  with  future  releases  of  TRSDOS, 
do  not  use  this  bit 

Bit  e  —  |f  "1",  the  controller  is  capabie  of  double-density  mode. 

Bit5  —  "1"  indicates  that  this  is  a  2-sided  floppy  diskette;  "0"  indicates  a 
1-sided  floppy  disk.  Do  not  confuse  this  bit  with  Bit  4  of  DCT +3, 
This  bit  shows  if  the  disk  is  double-sided;  Bit  4  of  DCT  +  3  tells  the 
controller  what  side  the  current  I/O  is  to  be  on, 

If  the  hard  drive  bit  (DCT  +  3,  Bit  3)  is  set,  a  "1"  denotes  double  the 
cylinder  count  stored  in  DCT +  6,  (This  implies  that  a  logical  cylin- 
der is  made  up  of  two  physical  cylinders.) 

Bit  4  —  If  "1"  indicates  an  alien  (non-standard)  disk  controller, 

Bits  0-3 — Contain  the  physical  drive  address  by  bit  selection  (0001,  0010, 
0100,  and  1000  equal  logical  Drives  0, 1,  2,  and  3,  respectively,  in 
a  default  system).  The  system  supports  a  translation  only  where  no 
more  than  one  bit  can  be  set, 

If  the  alien  bit  (Bit  4)  is  set,  these  bits  may  indicate  the  starting  head 
number 


UV/i  T3 


Contains  the  current  cylinder  position  of  the  drive,  It  normally  stores  a  copy  of 
the  Floppy  Disk  Controller's  track  register  contents  whenever  the  FDC  is 
selected  for  access  to  this  drive  It  can  then  be  used  to  reload  the  track  register 
whenever  the  FDC  is  reselected. 

If  the  alien  bit  (DCT  +  4,  Bit  4)  is  set,  DCT  +  5  may  contain  the  drive  select  code 
for  the  alien  controller 

DCT +6 

Contains  the  highest  numbered  cylinder  on  the  drive.  Since  cylinders  are  num- 
bered from  zero,  a  35-track  drive  is  recorded  as  X'22,'  a  40-track  drive  as  X'27/ 
and  an  80-track  drive  as  X'4F  If  the  hard  drive  bit  (DCT  +  3,  Bit  3)  is  set,  the  true 
cylinder  count  depends  on  DCT +  4,  Bit  5.  If  that  bit  is  a  'T  DCT +  6  contains 
only  half  of  the  true  cylinder  count, 

DCT +  7 

Contains  allocation  information. 

Bits  5-7— Contain  the  number  of  heads  for  a  hard  drive. 

Bits  0-4 —  Contain  the  highest  numbered  sector  relative  to  zero,  A  10- 
sector-per-track  drive  would  show  X'OSt'  If  DCT +  4,  Bit  5  indicates 
2-sided  operation,  the  sectors  per  cylinder  equals  twice  this 
number. 

DCT +8 

Contains  additional  allocation  information, 

Bits  5-7— Contain  the  number  of  granules  per  track  allocated  in  the  for- 
matting process.  If  DCT +  4,  Bit  5  indicates  2-sided  operation,  the 
granules  per  cylinder  equals  twice  this  number.  For  a  hard  drive, 
this  number  is  the  total  granules  per  cylinder. 

Bits  0-4— Contain  the  number  of  sectors  per  granule  that  was  used  in  the 
formatting  operation, 

DCT +  9 

Contains  the  number  of  the  cylinder  where  the  directory  is  located.  For  any 
directory  access,  the  system  first  attempts  to  use  this  value  to  read  the  direc- 
tory. If  this  operation  is  unsuccessful,  the  system  examines  the  BOOT  granule 
(cylinder  0)  directory  address  byte, 


Software  1 2 


Disk  I/O  Table 


Bytes  DCT  +  6,  DCT  +  7,  and  DCT  +  8  must  relate  without  conflicts.  That  is,  the 
highest  numbered  sector  (  +  1)  divided  by  the  number  of  sectors  per  granule 
( + 1 )  must  equal  the  number  of  granules  per  track  ( + 1  )„ 


TRSDOS  interfaces  with  hardware  peripherals  by  means  of  software  drivers. 
The  drivers  are,  in  general,  coupled  to  the  operating  system  through  data 
parameters  stored  in  the  system's  many  tables,  In  this  way,  hardware  not  cur- 
rently supported  by  TRSDOS  can  easily  be  supported  by  generating  driver  soft- 
ware and  updating  the  system  tables., 

Disk  drive  sub-systems  (such  as  controllers  for  SW  drives,  8"  drives,  and  hard 
disk  drives)  have  many  parameters  addressed  in  the  Drive  Code  Table  (DCT)„ 
Besides  those  operating  parameters,  controllers  also  require  various  com- 
mands (SELECT,  SECTOR  READ,  SECTOR  WRITE,  and  so  on)  to  control  the 
physical  devices*  TRSDOS  has  defined  command  conventions  to  deal  with 
most  commands  available  on  standard  Disk  Controllers. 

The  function  value  (hexadecimal  or  decimal)  you  wish  to  pass  to  the  driver 
should  go  in  register  B„  The  available  functions  are: 

Hex        Dec        Function Operation  Performed 

Test  to  see  if  drive  is  assigned  in  DCT 

Select  a  new  drive  and  return  status 

Set  to  cylinder  0,  restore,  set  side  0 

Reset  the  Floppy  Disk  Controller 

Issue  FDC  RESTORE  command 

Issue  FDC  STEP  IN  command 

Seek  a  cylinder 

Test  to  see  if  requested  drive  is  busy 

Read  sector  header  information 

Read  sector 

Verify  if  the  sector  is  readable 

Issue  an  FDC  track  read  command 

Format  the  device 

Write  a  sector 

Write  a  system  sector  (for  example,  directory) 

Issue  an  FDC  track  write  command 

Function  codes  X'1©'  to  X'FF'  are  reserved  for  future  use 


xw 

0 

DCSTAT 

x'or 

1 

SELECT 

X'02* 

2 

DCINIT 

X'03* 

3 

DCRES 

X'04' 

4 

RSTOR 

XW 

5 

STEPI 

xw 

6 

SEEK 

XV 

7 

TSTBSY 

xw 

8 

RDHDR 

X'09' 

9 

RDSEC 

X'0A' 

10 

VRSEC 

X'0B' 

11 

RDTRK 

X'0C 

12 

HDFMT 

X'0D' 

13 

WRSEC 

X'OE* 

14 

WRSYS 

X'0F 

15 

WRTRK 

Directory  Records  (DIREC) 


The  directory  contains  information  needed  to  access  all  flies  on  the  disk,  The 
directory  records  section  is  limited  to  a  maximum  of  32  sectors  because  of 
physical  limitations  in  the  Hash  Index  Table,  Two  additional  sectors  in  the  direc- 
tory cylinder  are  used  by  the  system  for  the  Granule  Allocation  Table  and  the 
Hash  Index  Table-  The  directory  is  contained  on  one  cylinder,  Thus,  a  1 0-sector- 
per-cylinder  formatted  disk  has,  at  most,  eight  directory  sectors.  See  the  sec- 
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Sectors 

User  Files 

User 

per 

Directory 

on  Data 

Files  on 

Cylinder 

Sectors 

Disk** 

SYS  Disk 

10 

8 

62 

48 

20 

18 

142 

128 

18 

16 

126 

112 

36 

32 

254 

240 

16 

14 

110 

96 

32 

30 

238 

224 

30 

PR 

22? 

208 

60 

32 

254 

240 

tion  on  the  Hash  index  Table  for  the  formula  to  calculate  the  number  of  directory 
sectors. 

A  directory  record  is  32  bytes  in  length,,  Each  directory  sector  contains  eight 
directory  records  (256/32  =  8).  On  system  disks,  the  first  two  directory  records 
of  the  first  eight  directory  sectors  are  reserved  for  system  overlays.  The  total 
number  of  files  possible  on  a  disk  equals  the  number  of  directory  sectors  times 
eight  (since  256/32  =  8),  The  number  available  for  use  is  reduced  by  16  on  sys- 
tem disks  to  account  for  those  record  slots  reserved  for  the  operating  system. 
The  following  table  shows  the  directory  record  capacity  (file  capacity)  of  each 
format  type.  The  dash  suffix  (-1  or  -2)  on  the  items  in  the  density  column  rep- 
resents the  number  of  sides  formatted  (for  example,  SDEN-1  means  single 
density,  1-sided). 


5"  SDEN-1 
5"  SDEN-2 
5"  DDEN-1 
5"  DDEN-2 
8"  SDEN-1 
8"  SDEN-2 
8"  ODFM-1 
8"  DDEN-2 
Hard  Disk* 

*Hard  drive  format  depends  on  the  drive  size  and  type,  as  well  as  the  user's 
division  of  the  physical  drive  into  logical  drives.  After  setting  up  and  format- 
ting the  drive,  you  can  use  the  FREE  library  command  to  see  the  available 
files. 

**Note:  Two  directory  records  are  reserved  for  BOOT/SYS  and  DIR/SYS, 
and  are  included  in  the  figures  for  this  column 

TRSDOS  Version  6  is  upward  compatible  with  other  TRSDOS  2,3  compatible 
operating  systems  in  its  directory  format.  The  data  contained  in  the  directory 
has  been  extended,  An  SVC  is  included  to  either  display  an  abbreviated  direc- 
tory or  place  its  data  in  a  user-defined  buffer  area.  For  detailed  information,  see 
the  @DODIR  and  @RAMDIR  SVCs, 

The  following  information  describes  the  contents  of  each  directory  field: 

DIR  +  0 

Contains  all  attributes  of  the  designated  file. 

Bit  7—  If  "0,"  this  flag  indicates  that  the  directory  record  is  the  file's  primary 
directory  entry  (FPDE).  If  "1,"  the  directory  record  is  one  of  the  file's 
extended  directory  entries  (FXDE).  Since  a  directory  entry  can 
contain  information  on  up  to  four  extents  (see  notes  on  the  extent 
fields,  beginning  with  DIR  +  22),  a  file  that  is  fractured  into  more 
than  four  extents  requires  additional  directory  records. 

Bit  6  — Specifies  a  SYStem  file  if  "1,"  a  nonsystem  file  if  "0." 

Bit  5  —  If  set  to  "1,"  indicates  a  Partition  Data  Set  (PDS)  file 

Bit  4  —  Indicates  whether  the  directory  record  is  in  use  or  not.  If  set  to  "1," 
the  record  is  in  use.  If  "0,"  the  directory  record  is  not  active, 
although  it  may  appear  to  contain  directory  information.  In  contrast 
to  some  operating  systems  that  zero  out  the  directory  record  when 
you  remove  a  file,  TRSDOS  only  resets  this  bit  to  zero. 

Bit  3™  Specifies  the  visibility.  If  "1,"  the  file  is  IN  Visible  to  a  directory  dis- 
play or  other  library  function  where  visibility  is  a  parameter.  If  a  "0," 
then  the  file  is  Visible,  (The  file  can  be  referenced  if  specified  by 
name  by  an  @!NIT  or  @OPEN  SVC) 
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Bits  0-2— Contain  the  USER  protection  level  of  the  file.  The  3-bit  binary 
value  is  one  of  the  following: 

0-FULL  2 -RENAME     4- UPDATE      6 -EXECUTE 

1 -REMOVE     3 -WRITE         5 -READ  7 -NO  ACCESS 

DIR  +  1 

Contains  various  file  flags  and  the  month  field  of  the  packed  date  of  last 
modification, 

Bit7™Set  to  "1"  if  the  file  was  "CREATEd"  (see  CREATE  library  com- 
mand in  the  Disk  System  Owner's  Manual).  Since  the  CREATE 
command  can  reference  a  file  that  is  currently  existing  but  non- 
CREATEd,  it  can  turn  a  non-CREATEd  file  into  a  CREATEd  one 
You  can  achieve  the  same  effect  by  changing  this  bit  to  a  "1" 

Bit  6™  If  set  to  "1,"  the  file  has  not  been  backed  up  since  its  last  modifica- 
tion. The  BACKUP  utility  is  the  only  TRSDOS  facility  that  resets 
this  flag.  It  is  set  during  the  close  operation  if  the  File  Control  Block 
(FCB  +  0,  Bit  2)  shows  a  modification  of  file  data 

Bit  5 —  If  set  to  "1,"  indicates  a  file  in  an  open  condition  with  UPDATE 
access  or  greater 

Bit  4 — If  the  file  was  modified  during  a  session  where  the  system  date  was 
not  maintained,  this  bit  is  set  to  "1"  This  specifies  that  the  packed 
date  of  modification  (if  any)  stored  in  the  next  three  fields  is  not  the 
actual  date  the  modification  occurred  If  this  bit  is  "1,"  the 
directory  command  displays  plus  signs  (  + )  between  the  date 
fields, 

Bits  0-3™- Contain  the  binary  month  of  the  last  modification  date  If  this 
field  is  a  zero,  DATE  was  not  set  when  the  file  was  established  or 
since  if  it  was  updated., 

DIR  +  2 

Contains  the  remaining  date  of  modification  fields. 

Bits  3-7 — Contain  the  binary  day  of  last  modification., 

Bits  0-2 — Contain  the  binary  year  minus  80.,  For  example,  1980  is  coded 
as  000, 1981  as  001, 1982  as  010,  and  so  on, 

DIR  +  3 

Contains  the  end-of-file  offset  byte.  This  byte  and  the  ending  record  number 
(ERN)  form  a  pointer  to  the  byte  position  that  follows  the  last  byte  written.,  This 
assumes  that  programmers,  interfacing  in  machine  language,  properly  main- 
tain the  next  record  number  (NRN)  offset  pointer  when  the  file  is  closed., 

DIR  +  4 

Contains  the  logical  record  length  (LRL)  specified  when  the  file  was  generated 
or  when  it  was  later  changed  with  a  CLONE  parameter 

DIR  +  5  through  DiR-f  12 

Contain  the  name  field  of  the  filespea  The  filename  is  left  justified  and  padded 
with  trailing  blanks. 

DIR  +  13throughDIR4-15 

Contain  the  extension  field  of  the  filespea  It  is  left  justified  and  padded  with 
trailing  blanks. 

D!R  +  16andDIR  +  17 

Contain  the  OWNER  password  hash  code, 

DIR  + 18  and  DIR  + 19 

Contain  the  USER  password  hash  code.  The  protection  level  in  DIR  +  0  is  asso- 
ciated with  this  password, 
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DIR +20  and  DIR +  21 

Contain  the  ending  record  number  (ERN),  which  is  based  on  full  sectors.  If  the 
ERN  is  zero,  it  indicates  that  no  writing  has  taken  place  (or  that  the  file  was  not 
closed  properly).  If  the  LRL  is  not  256,  the  ERN  represents  the  sector  where  the 
EOF  occurs.  You  should  use  ERN  minus  1  to  account  for  a  value  relative  to  sec- 
tor 0  of  the  file. 

DIR +  22  and  DIR +  23 

This  is  the  first  extent  field.  Its  contents  indicate  which  cylinder  stores  the  first 
granule  of  the  extent,  which  relative  granule  it  is,  and  how  many  contiguous 
grans  are  in  use  in  the  extent 

DIR  +  22 —Contains  the  cylinder  value  for  the  starting  gran  of  that  extent. 

DIR  +  23,  Bits  5-7  —  Contain  the  number  of  the  granule  in  the  cylinder  indi- 
cated by  DiR  +  22  which  is  the  first  granule  of  the  file  for  that 
extent.  This  value  is  relative  to  zero  ("0"  denotes  the  first  gran, 
"1"  denotes  the  second,  and  so  on). 

DIR +  23,  Bits  0-4-™  Contain  the  number  of  contiguous  granules,  relative 
to  0  ("0"  denotes  one  gran,  "1"  denotes  two,  and  so  on).  Since 
the  field  is  five  bits,  it  contains  a  maximum  of  X'1  F'  or  31,  which 
represents  32  contiguous  grans. 
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Contain  the  fields  for  the  second  extent.  The  format  is  identical  to  that  for 
Extent  1. 

DIR +  26  and  DIR +  27 

Contain  the  fields  for  the  third  extent.  The  format  is  identical  to  that  for  Extent  1. 

DIR+28andDIR  +  29 

Contain  the  fields  for  the  fourth  extent.  The  format  is  identical  to  that  for 
Extent  1. 

DIR +  30 

This  is  a  flag  noting  whether  or  not  a  link  exists  to  an  extended  directory  record. 
If  no  further  directory  records  are  linked,  the  byte  contains  X'FF' A  value  of  X'FE' 
in  this  byte  establishes  a  link  to  an  extended  directory  entry.  (See  "Extended 
Directory  Records"  below.) 

DIR +  31 

This  is  the  link  to  the  extended  directory  entry  noted  by  the  previous  byte.  The 
link  code  is  the  Directory  Entry  Code  (DEC)  of  the  extended  directory  record. 
The  DEC  is  actually  the  position  of  the  Hash  Index  Table  byte  mapped  to  the 
directory  record.  For  more  information,  see  the  section  "Hash  Index  Table!' 

Extended  Directory  Records 

Extended  directory  records  (FXDE)  have  the  same  format  as  primary  directory 
records,  except  that  only  Bytes  0,  1,  and  21-31  are  utilized.  Within  Byte  0,  only 
Bits  4  and  7  are  significant.  Byte  1  contains  the  DEC  of  the  directory  record  of 
which  this  is  an  extension.  An  extended  directory  record  may  point  to  yet 
another  directory  record,  so  a  file  may  contain  an  "unlimited"  number  of  extents 
(limited  only  by  the  total  number  of  directory  records  available), 


Granule  Allocation  Table  (GAT) 


The  Granule  Allocation  Table  (GAT)  contains  information  on  the  free  and 
assigned  space  on  the  disk.  The  GAT  also  contains  data  about  the  formatting 
used  on  the  disk. 
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A  disk  is  divided  into  cylinders  (tracks)  and  sectors.  Each  cylinder  has  a  spec- 
ified number  of  sectors.,  A  group  of  sectors  is  allocated  whenever  additional 
space  is  needed  This  group  is  called  a  granule.  The  number  of  sectors  per 
granule  depends  on  the  total  number  of  sectors  available  on  a  logical  drive.  The 
GAT  provides  for  a  maximum  of  eight  granules  per  cylinder 

in  the  GAT  bytes,  each  bit  set  to  "1"  indicates  a  corresponding  granule  in  use 
(or  locked  out).  Each  bit  reset  to  "0"  indicates  a  granule  free  to  be  used,  in  a 
GAT  byte,  bit  0  corresponds  to  the  first  relative  granule,  bit  1  to  the  second  rel- 
ative granule,  bit  2  the  third,  and  so  on,  A  SVa"  single  density  diskette  is  format- 
ted at  10  sectors  per  cylinder,  5  sectors  per  granule,  2  granules  per  cylinder 
Thus,  that  configuration  uses  only  bits  0  and  1  of  the  GAT  byte.,  The  remainder 
of  the  GAT  byte  contains  al!  fs,  denoting  unavailable  granules.  Other  formatting 
conventions  are  as  follows: 


Sectors 

Sectors 

Granules 

Maximum 

per 

per 

per 

No,  of 

Cylinder 

Granule 

Cylinder 

Cylinders 

5"  SDEN 

10 

5 

2 

80 

5"  DDEN 

18 

6 

3 

80 

8"  SDEN 

16 

8 

2 

77 

8"  DDEN 

30 

10 

3 

77 

Hard  Disk 

32 

16 

8 

153 

*Hard  drive  format  depends  on  the  drive  size  and  type,  as  well  as  the  user's  divi- 
sion of  the  drive  into  logical  drives  These  values  assume  that  one  physical 
hard  disk  is  treated  as  one  logical  drive 

The  above  table  is  valid  for  single-sided  disks.  TRSDOS  supports  double-sided 
operation  if  the  hardware  interfacing  the  physical  drives  to  the  CPU  allows  it,  A 
two-headed  drive  functions  as  a  single  logical  drive,  with  the  second  side  as  a 
cylinder-for-cylinder  extension  of  the  first  side.  A  bit  in  the  Drive  Code  Table 
(DCT+4,  Bit  5)  indicates  one-sided  or  two-sided  drive  configuration 

A  Winchester-type  hard  disk  can  be  divided  by  heads  into  multiple  logical 
drives.  Details  are  supplied  with  Radio  Shack  drives. 

The  Granule  Allocation  Table  is  the  first  relative  sector  of  the  directory  cylinder, 
The  following  information  describes  the  layout  and  contents  of  the  GAT 

GAT  +  X'O0'  through  GAT  +  X'5F' 

Contains  the  free/assigned  table  information  GAT  +  0  corresponds  to  cylinder 
0,  GAT  +  1  corresponds  to  cylinder  1,  GAT  +  2  corresponds  to  cylinder  2,  and  so 
on.  As  noted  above,  bit  0  of  each  byte  corresponds  to  the  first  granule  on  the 
cylinder,  bit  1  to  the  second  granule,  and  so  on  A  value  of  "1"  indicates  the 
granule  is  not  available  for  use 

GAT  +  X'60'  through  GAT  +  X'BF 

Contains  the  available/locked  out  table  information.  It  corresponds  cylinder  for 
cylinder  in  the  same  way  as  the  free/assigned  table.,  It  is  used  during  mirror- 
image  backups  to  determine  if  the  destination  diskette  has  the  proper  capacity 
to  effect  a  backup  of  the  source  diskette,  This  table  does  not  exist  for  hard 
disks;  for  this  reason,  mirror-image  backups  cannot  be  performed  on  hard  disk, 

GAT  +  X'C0'  through  GAT  +  X'CA 

Used  in  hard  drive  configurations;  extends  the  free/assigned  table  from  X'00* 
through  X'CAMHard  drive  capacity  up  to  203  (0-202)  logical  or  406  physical  cyl- 
inders is  supported 

GAT  +  X'CB' 

Contains  the  operating  system  version  that  was  used  in  formatting  the  disk. 
For  example,  disks  formatted  under  TRSDOS  6  2  have  a  value  of  X'62' 
contained  in  this  byte  It  is  used  to  determine  whether  or  not  the  disk 
contains  all  of  the  parameters  needed  for  TRSDOS  operation 
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GAT+X'CC 

Contains  the  number  of  cylinders  in  excess  of  35,  It  is  used  to  minimize  the  time 
required  to  compute  the  highest  numbered  cylinder  formatted  on  the  disk.  It  is 
excess  35  to  provide  compatibility  with  aiien  systems  not  maintaining  this  byie. 
If  you  have  a  disk  that  was  formatted  on  an  alien  system  for  other  than  35  cyl- 
inders, this  byte  can  be  automatically  configured  by  using  the  REPAIR  utility, 
(See  the  section  on  the  REPAIR  utility  in  the  Disk  System  Owner's  Manual) 

GAT  +  X'CD' 

Contains  data  about  the  formatting  of  the  disk 

Bit  7™  If  set  to  "IT  the  disk  is  a  data  disk.  If  "0"  the  disk  is  a  system  disk. 

Bit  6  — If  set  to  "1"  indicates  double-density  formatting.  If  "0"  indicates 
single-density  formatting. 

Bit  5— If  set  to  'T  indicates  2-sided  disk.  If  "0,"  indicates  1-sided  disk. 

Bits  3-4 — Reserved, 

Bits  0-2 — Contain  the  number  of  granules  per  cylinder  minus  1 

GAT  +  X'CE'  and  GAT+X'CF 

Contain  the  16-bit  hash  code  of  the  disk  master  password.  The  code  is  stored 
in  standard  low-order,  high-order  format 

GAT+XW  through  GAT+X'D7' 

Contain  the  disk  name.  This  is  the  name  displayed  during  a  FREE  or  DIR  oper- 
ation. The  disk  name  is  assigned  during  formatting  or  during  an  ATTRIB  disk 
renaming  operation.  The  name  is  left  justified  and  padded  with  blanks, 

GAT+X'D8'  through  GAT+X'DF 

Contain  the  date  that  the  diskette  was  formatted  or  the  date  that  it  was  used  as 
the  destination  in  a  mirror  image  backup  operation  in  the  format  mm/dd/yy, 

GAT  +  X'E0'  through  GAT+XTF 

Reserved  for  system  use, 

In  Version  6.2: 

GAT  +  X'EO'  through  GAT  +  XT4' 

Reserved  for  system  use 

GAT+XT5'  through  GAT+XTF 

Contain  the  Media  Data  Block  (MDB). 

GAT  +  X'F5'  through  GAT  +  X'F8'  —  the  identifying  header.  These  four 
bytes  contain  a  3  (X'03'),  followed  by  the  letters  LSI  {X4C ,Xl53' ,Xl49') 

GAT  +  X'F8'  through  GAT9  +  X'FF'  —  the  last  seven  bytes  of  the  DCT 
in  use  when  the  media  was  formatted.  FORMAT,  MemDISK,  and 
TRSFORM6  install  this  information  See  Drive  Control  Table  (DCT)  for 
more  information  on  these  bytes 


Hash  index  Table  (HIT) 


The  Hash  Index  Table  is  the  key  to  addressing  any  file  in  the  directory.  It  pin- 
points the  location  of  a  file's  directory  with  a  minimum  of  disk  accesses,  keeping 
overhead  low  and  providing  rapid  file  access. 

The  system's  procedure  is  to  construct  an  11-byte  filename/extension  field.  The 
filename  is  left-justified  and  padded  with  blanks.  The  file  extension  is  then 
inserted  and  padded  with  blanks;  it  occupies  the  three  least  significant  bytes  of 
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the  11-byte  field.  This  field  is  processed  through  a  hashing  algorithm  which  pro- 
duces  a  single  byte  value  in  the  range  X'01'  through  X'FR  (A  hash  value  of  X  W 
indicates  a  spare  HIT  position,) 

The  system  then  stores  the  hash  code  in  the  Hash  index  Table  (HIT)  at  a  posi- 
tion corresponding  to  the  directory  record  that  contains  the  file's  directory.  Since 
more  than  one  11-byte  string  can  hash  to  identical  codes,  the  opportunity  for 
"collisions"  exists.  For  this  reason,  the  search  algorithm  scans  the  HIT  for  a 
matching  code  entry,  reads  the  directory  record  corresponding  to  the  matching 
HIT  position,  and  compares  the  filename/extension  stored  in  the  directory  with 
that  provided  in  the  file  specification.  If  both  match,  the  directory  has  been 
found.  If  the  two  fields  do  not  match,  the  HIT  entry  was  a  collision  and  the  algo- 
rithm continues  its  search  from  the  next  HIT  entry. 

The  position  of  the  HIT  entry  in  the  hash  table  is  called  the  Directory  Entry  Code 
(DEC)  of  the  file.  All  files  have  at  least  one  DEC,  Files  that  are  extended  beyond 
four  extents  have  a  DEC  for  each  extended  directory  entry  and  use  more  than 
one  filename  slot.  To  maximize  the  number  of  file  slots  available,  you  should 
keep  your  files  below  five  extents  where  possible. 

Each  HIT  entry  is  mapped  to  the  directory  sectors  by  the  DEC's  position  in  the 
HIT  Think  of  the  HIT  as  eight  rows  of  32-byte  fields.  Each  row  is  mapped  to  one 
of  the  directory  records  in  a  directory  sector:  The  first  HIT  row  is  mapped  to  the 
first  directory  record,  the  second  HIT  row  to  the  second  directory  record,  and  so 
on,  Each  column  of  the  HIT  field  (0-31 )  is  mapped  to  a  directory  sector,  The  first 
column  is  mapped  to  the  first  directory  sector  in  the  directory  cylinder  (not 
including  the  GAT  and  HIT),  Therefore,  the  first  column  corresponds  to  sector 
2,  the  second  column  to  sector  3,  and  so  on.  The  maximum  number  of  HIT  col- 
umns used  depends  on  the  disk  formatting  according  to  the  formula: 
N  ~  number  of  sectors  per  cylinder  minus  two,  up  to  32. 

The  following  chart  shows  the  correlation  of  the  Hash  Index  Table  to  the  direc- 
tory records.  Each  byte  value  shown  represents  the  position  in  the  HIT  This 
position  value  is  the  DEC,  The  actual  contents  of  each  byte  is  either  a  X(00) 
indicating  a  spare  slot,  or  the  1-byte  hash  code  of  the  file  that  occupies  the  cor- 
responding directory  record. 


Columns 


ROW  1     00      01       02      03      04      05      06      07      08      09      0A      0B     0C     0D     0E      0F 
10      11       12      13      14      15      16      17      18      19      1A      1B      1C     1D      1E      1F 

Row  2    20      21      22      23      24      25      26      27      28      29      2A     2B     2C     2D     2E      2F 
30      31      32      33      34      35      36      37      38      39      3A     3B     3C     3D     3E      3F 

Row  3    40      41       42      43      44      45      46      47      48      49      4A     4B     4C     4D     4E      4F 
50      51       52      53      54      55      56      57      58      59      5A     5B     5C     5D     5E      5F 

Row  4    60      61      62      63      64      65      66      67      68      69      6A     6B     6C     6D     6E      6F 
70      71       72      73      74      75      76      77      78      79      7A     7B     7C     7D      7E      7F 

Row5    80      81      82      83      84      85      86      87      88      89      8A     8B     8C     8D     8E      8F 
90      91      92      93      94      95      96      97      98      99      9A     9B     9C     9D     9E      9F 

Row  6    A0     A1      A2     A3     A4     A5      A6     A7     A8      A9     AA     AB     AC    AD     AE     AF 
B0      B1      B2     B3     B4      B5      B6     B7     B8     B9     BA     BB     BC    BD     BE     BF 

Row  7    C0     C1      C2     C3     C4     C5     C6     C7     C8     C9     CA     CB     CC    CD     CE     CF 
D0     D1      D2     D3     D4      D5      D6      D7     D8     D9     DA     DB     DC    DD     DE     DF 

Row  8    E0      E1      E2     E3     E4      E5      E6      E7     E8      E9     EA     EB     EC    ED     EE     EF 
F0      F1      F2      F3      F4      F5      F6      F7      F8      F9      FA     FB     FC     FD     FE      FF 

A  5Va"  single  density  disk  has  1 0  sectors  per  cylinder,  two  of  which  are  reserved 
for  the  GAT  and  HIT  Since  only  eight  directory  sectors  are  possible,  only  the 
first  eight  positions  of  each  HIT  row  are  used.  Other  formats  use  more  columns 
of  the  HIT,  depending  on  the  number  of  sectors  per  cylinder  in  the  formatting 
scheme. 

The  eight  directory  records  for  sector  2  of  the  directory  cylinder  correspond  to 
assignments  in  HIT  positions  00,  20,  40,  60,  80,  A0,  CO,  and  E0.  On  system 


Software  1 9 


disks,  the  following  positions  are  reserved  for  system  overlays,  On  data  disks, 
these  positions  (except  for  00  and  01)  are  available  to  the  user, 

00  —  BOOT/SYS  20  —  SYS6/SYS 

01-D1R/SYS  21-SYS7/SYS 

02  —  SYS0/SYS  22  —  SYS8/SYS 

03  —  SYS1  /SYS  23  —  SYS9/SYS 

04  —  SYS2/SYS  24  —  SYS10/SYS 

05  —  SYS3/SYS  25  —  SYS1 1  /SYS 

06  —  SYS4/SYS  26  —  SYS12/SYS 

07  —  SYS5/SYS  27  —  SYS13/SYS 

These  entry  positions  correspond  to  the  first  two  rows  of  each  directory  sector 
for  the  first  eight  directory  sectors.  Since  the  operating  system  accesses  these 
overlays  by  position  in  the  HIT  rather  than  by  filename,  these  positions  are 
reserved  on  system  disks 

The  design  of  the  Hash  Index  Table  limits  the  number  of  files  on  any  one  drive 
to  a  maximum  of  256, 


Locatsna  a  Directory  Record 


Because  of  the  coding  scheme  used  on  the  entries  in  the  HIT  table,  you  can 
locate  a  directory  record  with  only  a  few  instructions.  The  instructions  are: 


AND   iFH 

ADD   A*2 


and 

AND   0E0H 


(calculates  the  sector) 


(calculates  the  offset  in  that  sector) 

For  example,  if  you  have  a  Directory  Entry  Code  (DEC)  of  XW.the  following 
occurs  when  these  instructions  are  performed: 

Value  of  accumulator 
A  =  X'84' 

AND      1FH 

A  =  X'04' 

ADD      A#Z 

A  =  X'06' 

The  record  is  in  the  seventh 

sector  of  the  directory  cylinder 

(0-6) 

Using  the  Directory  Entry  Code  (DEC)  again,  you  can  find  the  offset  into  the 
sector  that  was  found  using  the  above  instructions  by  executing  one 
instruction: 

Value  of  accumulator 
A  =  Xl84' 

A  =  X'80' 
The  directory  record  is  X'80'  (128) 
bytes  from  the  beginning  of 
the  sector 

If  the  record  containing  the  sector  is  loaded  on  a  256-byte  boundary  (LSB  of  the 
address  is  XW)  and  HL  points  to  the  starting  address  of  the  sector,  then  you 
can  use  the  above  value  to  calculate  the  actual  address  of  the  directory  record 
by  executing  the  instruction: 


AND      0E0H 


LD         L»A 
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When  executed  after  the  calculation  of  the  offset,  this  causes  HL  to  point  to  the 
record.  For  example: 

A  =  X'80* 

LD       HL  *4200H     ;Where  sector  is  loaded 
LD       L»A  ;ReplaceLSB  with  offset 

HL  now  contains  4280H,  which  is  the  address  of  the  directory  record  you 
wanted., 

If  you  cannot  place  the  sector  on  a  256-byte  boundary,  then  you  can  use  the 
following  instructions: 

A-X'80' 

LD       HL  ,425SH     ;Where  sector  is  loaded 
LD       E,A  ;Put  offset  in  E  (LSB) 

LD       D  »0  ;Put  a  zero  in  D  (MSB) 

ADD     HLfDE  ;Add  two  values  together 

HL  now  contains  42D6H,  which  is  the  address  of  the  directory  record. 

Note  that  the  first  DEC  found  with  a  matching  hash  code  may  be  the  file's 
extended  directory  entry  (FXDE).  Therefore,  if  you  are  going  to  write  system 
code  to  deal  with  this  directory  scheme,  you  must  properly  deal  with  the  FPDE/ 
FXDE  entries,  See  Directory  Records  for  more  information. 
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6/FiSe  Control 


File  Control  Block  (FCB) 


The  File  Control  Block  (FCB)  is  a  32-byte  memory  area.  Before  the  file  is 
opened,  this  space  holds  the  file's  filespec  After  an  @OPEN  or  @INIT  super- 
visor call  is  performed,  the  system  uses  this  area  to  interface  with  the  file,  and 
replaces  the  filespec  with  other  information,  When  the  file  is  closed,  the  filespec 
(without  any  specified  password)  is  returned  to  the  FCB, 

While  a  file  is  open,  the  contents  of  the  FCB  are  dynamic,  As  records  are  written 
to  or  read  from  the  disk  file,  specific  fields  in  the  FCB  are  modified.  Avoid  chang- 
ing the  contents  of  the  FCB  during  the  time  a  file  is  open,  unless  you  are  sure 
that  the  change  will  not  affect  the  integrity  of  the  file. 

During  most  system  access  of  the  FCB,  the  IX  index  register  is  used  to  refer- 
ence each  field  of  data.  Register  pair  DE  is  used  mainly  for  the  initial  reference 
to  the  FCB  address.  The  information  contained  in  each  field  of  the  FCB  is  as 
follows: 

FCB  +  0 

Contains  the  TYPE  code  of  the  control  block. 

Bit  7  —  If  set  to  "1,"  indicates  that  the  file  is  in  an  open  condition;  if  "0,"  the 
file  is  assumed  closed,  This  bit  can  be  tested  to  determine  the 
"open"  or  "closed"  status  of  an  FCB. 

Bit  6™  is  set  to  "1"  if  the  file  was  opened  with  UPDATE  access  or  higher 

Bit  5  — Indicates  a  Partition  Data  Set  (PDS)  type  file. 

Bits  4-3 — Reserved  for  future  use. 

Bit  2™  Is  set  to  "1"  if  the  system  performed  any  WRITE  operation  on  this 
file.,  It  is  used  to  update  the  MOD  flag  in  the  directory  record  when 
the  file  is  closed. 

Bits  1-0  —  Reserved  for  future  use. 

FCB-M 

Contains  status  flag  bits  used  in  read/write  operations  by  the  system. 

Bit  7  — If  set  to  "1,"  indicates  that  I/O  operations  will  be  either  full  sector 
operations  or  byte  operations  of  logical  record  length  (LRL)  less 
than  256.  If  "0,"  only  sector  operations  will  be  performed.  If  you  are 
going  to  use  only  full-sector  I/O,  you  can  reduce  system  overhead 
by  specifying  the  LRL  at  open  time  as  0  (indicating  256)  An  LRL 
of  other  than  256  sets  bit  7  to  "1"  on  open. 

Bit  6—  If  set  to  *T  indicates  that  the  end  of  file  (EOF)  is  to  be  set  to  ending 
record  number  (ERN)  only  if  next  record  number  (NRN)  exceeds 
the  current  value  of  EOF  This  is  the  case  if  random  access  is  to  be 
used.  During  random  access,  the  EOF  is  not  disturbed  unless  you 
extend  the  file  beyond  the  last  record  slot.  Any  time  the  position 
routine  (@POSN)  is  called,  bit  6  is  automatically  set  If  bit  6  is  "0," 
then  EOF  will  be  updated  on  every  WRITE  operation., 

Bit  5™  If  "0,"  then  the  disk  I/O  buffer  contains  the  current  sector  denoted 
by  NRN,  If  set  to  "1,"  then  the  buffer  does  not  contain  the  current 
sector  During  byte  I/O,  bit  5  is  set  when  the  last  byte  of  the  sector 
is  read,  A  sector  read  resets  the  bit,  showing  the  buffer  to  be 
current, 
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Bit  4—  |f  set  to  "U'  indicates  that  the  buffer  contents  have  been  changed 
since  the  buffer  was  read  from  the  file.  It  is  used  by  the  system  to 
determine  whether  the  buffer  must  be  written  back  to  the  .ilo  ^efore 
reading  another  record.  If  "0,"  then  the  buffer  contents  were  not 
changed 

Bit  3  —  Used  to  specify  that  the  directory  record  is  to  be  updated  each  time 
the  NRN  exceeds  the  EOF.  (The  normal  operation  is  to  update  the 
directory  only  when  an  FCB  is  closed.)  Some  unattended  opera- 
tions may  use  this  extra  measure  of  file  protection.  It  is  specified  by 
adding  an  exclamation  mark  ("!")  to  the  end  of  a  filespec  when  the 
filespec  is  requested  at  open  time, 

Bits  2-0 —  Contain  the  user  (access)  protection  level  as  retrieved  from  the 
directory  of  the  file,  The  3-bit  binary  value  is  one  of  the  following: 
0-FULL  2 -RENAME      4- UPDATE      6  =  EXECUTE 

1=  REMOVE     3  =  WRITE         5 -READ  7  =  NO  ACCESS 

FCB +  2 

Used  by  Partition  Data  Set  (PDS)  files. 

FC84-3andFCB  +  4 

Contain  the  butter  address  in  iow-order,  hiyii-uidta  formal..  This  is  the  buffer 
address  specified  in  register  pair  HL  when  the  @INIT  or  @OPEN  SVC  is 
performed. 

FCB +  5 

Contains  the  relative  byte  offset  within  the  current  buffer  for  the  next  I/O  oper- 
ation. If  this  byte  has  a  zero  value,  then  FCB  + 1,  Bit  5  must  be  examined  to  see 
if  the  first  byte  in  the  current  buffer  is  the  target  position  or  if  it  is  the  first  byte  of 
the  next  record.  If  you  are  performing  sector  I/O  of  byte  data  (that  is,  maintain- 
ing your  own  buffering),  then  it  is  important  to  maintain  this  byte  when  you  close 
the  file  if  the  true  end  of  file  is  not  at  a  sector  boundary, 

FCB +  6 

Bits  3-7  —  Reserved  for  system  use. 

Bits  0-2 —Contain  the  logical  drive  number  in  binary  of  the  drive  contain- 
ing the  file.  Do  not  modify  this  byte;  altering  this  value  may  damage 
other  files.  This  byte  and  FCB +  7  are  the  only  links  to  the  file's 
directory  information, 

FCB +  7 

Contains  the  directory  entry  code  (DEC)  for  the  file.  This  code  is  the  offset  in  the 
Hash  Index  Table  where  the  hash  code  for  the  file  appears..  Do  not  modify  this 
byte;  altering  this  value  may  damage  other  files.  This  byte  and  FCB  +  6  are  the 
only  links  to  the  directory  information  for  the  file. 

FCB +  8 

Contains  the  end-of-file  byte  offset.  This  byte  is  similar  to  FCB +5  except  that  it 
pertains  to  the  end  of  file  rather  than  to  the  next  record  number 

FCB +  9 

Contains  the  logical  record  length  that  was  in  effect  when  the  file  was  opened. 
This  may  not  be  the  same  LRL  that  exists  in  the  directory.  The  directory  LRL  is 
generated  at  the  file  creation  and  never  changes  unless  the  file  is  overwritten. 

FCB  +  10andFCB  +  11 

Contain  the  next  record  number  (NRN),  which  is  a  pointer  for  the  next  I/O  oper- 
ation. When  a  file  is  opened,  NRN  is  zero,  indicating  a  pointer  to  the  beginning. 
Each  sequential  sector  I/O  advances  NRN  by  one. 
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FCB  +  12andFCB  +  13 

Contain  the  ending  record  number  (ERN)  of  the  file.,  This  is  a  pointer  to  the  sec- 
tor that  contains  the  end-of-file  indicator  In  a  null  file  (one  with  no  records), 
ERN  equals  0.  If  one  sector  has  been  written,  ERN  equals  t 

FCB +  14  and  FCB +  15 

Contain  the  same  information  as  the  first  extent  of  the  directory.  This  represents 
the  starting  cylinder  of  the  file  (FCB  -t- 14)  and  the  starting  relative  granule  within 
the  starting  cylinder  (FCB  +  15).  FCB  +  15  also  contains  the  number  of  contig- 
uous granules  allocated  in  the  extent,  These  bytes  are  used  as  a  pointer  to  the 
beginning  of  the  file  referenced  by  the  FCB, 

FCB +  16  through  FCB +  19 

This  4-byte  entry  contains  granule  allocation  information  for  an  extent  of  the  file. 
Relative  bytes  0  and  1  contain  the  total  number  of  granules  allocated  to  the  file 
up  to  but  not  including  the  extent  referenced  by  this  field.  Relative  byte  2  con- 
tains the  starting  cylinder  of  this  extent.  Relative  byte  3  contains  the  starting  rel- 
ative granule  for  the  extent  and  the  number  of  contiguous  granules, 

FCB  +  20  through  FCB  +  23 

Contain  information  similar  to  the  above  but  for  a  second  extent  of  the  file., 

FCB  +  24  through  FCB  +  27 

Contain  information  similar  to  the  above  but  for  a  third  extent  of  the  file. 

FCB +  28  through  FCB +  31 

Contain  information  similar  to  the  above  but  for  a  fourth  extent  of  the  file., 

The  file  control  block  contains  information  on  only  four  extents  at  one  time,  If 
the  file  has  more  than  four  extents,  additional  directory  accessing  is  done  to 
shift  the  4-byte  entries  in  order  to  make  space  for  the  new  extent  information 

Although  the  system  can  handle  a  file  of  any  number  of  extents,  you  should 
keep  the  number  of  extents  small.  The  most  efficient  file  is  one  with  a  single 
extent.  The  number  of  extents  can  be  reduced  by  copying  the  file  to  a  disk  that 
contains  a  large  amount  of  free  space. 
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7/TRSDOS  Version  6 
Programming  Guidelines 


Converting  to  TRSDOS  Version  6 


This  section  provides  suggestions  on  writing  programs  effectiveiy  with 
TRSDOS  Version  6,  and  on  converting  programs  created  with  TRSDOS  13 
and  LDOS  5.1  operating  systems  for  use  with  TRSDOS  Version  6.  This  infor- 
mation is  by  no  means  complete,  but  presents  some  important  concepts  to 
keep  in  mind  when  using  TRSDOS  Version  6, 

When  programming  in  assembly  language,  you  can  use  TRSDOS  Version  6 
routines  for  commonly  used  operations.  These  are  accessed  through  the 
supervisor  calls  (SVCs)  instead  of  absolute  call  addresses.  Nothing  in  the  sys- 
tem can  be  accessed  via  any  absolute  address  reference  (except  Z-80  RST 
and  NMI  jump  vectors) 

IMPORTANT  NOTE:  TRSDOS  provides  all  functions  and  storage  through 
supervisor  calls.  No  address  or  entry  point  below  3000H  is  documented  or  sup- 
ported by  Radio  Shack. 

The  keyboard  is  not  accessible  via  "peeking,"  and  the  video  RAM  cannot  be 
"poked"  The  keyboard  and  video  are  accessible  only  through  the  appropriate 
SVCs, 

Another  distinction  is  that  TRSDOS  Version  6  handling  of  logical  byte  I/O 
devices  (keyboard,  video,  printer,  communications  line)  completely  supports 
error  status  feedback.  A  FLAG  convention  is  uniform  throughout  these  device 
drivers  as  well  as  physical  byte  I/O  associated  with  files.  The  device  handling 
in  TRSDOS  Version  6  is  completely  independent.  That  means  that  byte  I/O, 
both  logical  and  physical,  can  be  routed,  filtered,  and  linked.,  Therefore,  it  is 
important  to  test  status  return  codes  in  all  applications  using  byte  I/O  regard- 
less of  the  device  that  the  application  expects  to  be  used,  since  re-direction  to 
some  other  device  is  possible  at  the  TRSDOS  level  Appropriate  action  must  be 
taken  when  errors  are  detected. 

Modules  loaded  into  memory  and  protected  by  lowering  HIGH$  must  include 
the  standard  header,  as  described  earlier  under  "Memory  Header."  The 
@GTMOD  supervisor  call  requires  that  this  header  be  present  in  every  resident 
module  for  proper  operation. 

The  file  password  protection  terms  of  UPDATE  and  ACCESS  have  been 
changed  in  TRSDOS  Version  6  to  OWNER  and  USER,  respectively.  The  addi- 
tional file  protection  level  of  UPDATE  has  been  added.  A  file  with  UPDATE  pro- 
tection level  can  be  read  or  written  to,  but  its  end  of  file  cannot  be  extended., 
This  protection  can  be  useful  in  a  random  access  fixed-size  file  or  in  a  file  where 
shared  access  is  to  take  place 

Files  opened  with  UPDATE  or  greater  access  are  indicated  as  open  in  their 
directory.  Attempting  to  open  the  file  again  forces  a  change  to  READ  access 
protection  and  a  "File  already  open"  error  code.  It  is  therefore  important  for 
applications  to  CLOSE  files  that  are  opened 

For  the  convenience  of  applications  that  access  files  only  for  reading,  you  can 
inhibit  the  "file  open  bit"  If  you  set  bit  0  of  the  system  flag  SFLAG$  (see  the 
©FLAGS  supervisor  call),  the  file  open  bit  is  not  set  in  the  file's  directory  Once 
set,  the  next  ©OPEN  or  @INIT  SVC  automatically  resets  bit  0  of  SFLAG$. 
Note  that  you  cannot  use  this  procedure  for  files  being  written  to,  since  it  inhibits 
the  CLOSE  process 
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Some  application  programs  need  access  to  certain  system  parameters  and 
variables.  A  number  of  flags,  variables,  and  port  images  can  be  accessed  rel- 
ative to  a  flag  pointer  obtained  via  the  @FLAGS  supervisor  call,  These  param- 
eters are  only  accessible  relative  to  this  pointer,  as  the  pointer's  location  may 
change  (See  the  explanation  of  the  @FLAGS  SVC.) 

All  applications  must  honor  the  contents  of  HIGH$,  This  pointer  contains  the 
highest  RAM  address  usable  by  any  program.  You  can  retrieve  and  change 
HIGH$  by  using  the  @HIGH$  SVC 

TRSDOS  Version  6  library  commands  and  utilities  supply  a  return  code  (RC)  at 
completion.  The  RC  is  returned  in  register  pair  HL  The  value  returned  is  either 
zero  (indicating  no  error),  a  number  from  one  through  62  (indicating  an  error  as 
noted  in  Appendix  A,  TRSDOS  Error  Messages),  or  X'FFFF'  (indicating  an 
extended  error  which  is  currently  not  assigned  an  error  number),  TRSDOS  Ver- 
sion 6  Job  Control  Language  (JCL)  aborts  on  any  program  terminating  with  a 
non-zero  RC  value.  Applications  should  therefore  properly  set  the  return  code 
register  pair  HL  before  exiting, 

TRSDOS  Version  6  library  commands  are  also  invokable  via  the  @CMNDR 
SVC  which  executes  the  command.  Library  commands  properly  maintain  the 
Stack  Pointer  (SP)  and  exit  via  a  RET  instruction.  In  this  manner,  control  is 
returned  to  the  invoking  program  with  the  RC  present  for  testing.  For  com- 
mands invoked  with  the  (&CMNDI  SVC  or  prompted  tor  via  trie  (a€XIT  SVC, 
the  SP  is  restored  to  the  system  stack.  The  top  of  the  stack  will  contain  an 
address  suitable  for  simulating  an  @EXIT  SVC;  thus,  if  your  application  pro- 
gram properly  maintains  the  integrity  of  the  stack  pointer,  it  can  exit  after  setting 
the  RC  via  a  RET  instruction  instead  of  an  (©EXIT  SVC 

TRSDOS  Version  6  diskette  and  file  structure  is  identical  to  that  used  in  LDOS 
51  This  includes  formatting,  directory  structure,  and  data  address  mark  con- 
ventions TRSDOS  Version  6  system  diskettes,  however,  use  the  entire  BOOT 
track  (track  0).  This  compatibility  means  that  data  files  may  be  used  inter- 
changeably between  LDOS  5.1  equipped  machines  and  TRSDOS  Version  6 
equipped  machines;  the  diskettes  themselves  are  readable  and  writable  across 
both  operating  systems 

The  methods  of  internal  handling  of  device  linking  and  filtering  have  been 
changed  from  LDOS  51,  (It  is  beyond  the  scope  of  this  manual  to  explain  the 
internal  functioning  of  TRSDOS  Version  6.)  Device  filters  must  adhere  to  a  strict 
protocol  of  linkage  in  order  to  function  properly  See  the  section  on  "Device 
Driver  and  Filter  Templates"  for  information  on  device  driver  and  filter  protocol, 

Stack  Handling  Restrictions* 

Interrupt  tasks  and  filters  that  deal  with  the  keyboard  or  video  must  not  place 
the  stack  pointer  above  X'F3FF,!  This  is  because  any  operation  that  requires  the 
keyboard  or  video  RAM  switches  in  the  3K  bank  at  X'F400'  and  suppresses  the 
stack  until  it  is  switched  out  again,  If  the  system  accesses  the  stack  at  any  time 
during  this  period,  the  integrity  of  the  stack  is  destroyed 


'In  TRSDOS  6,0  0,  the  stack  cannot  be  placed  above  X'F3FF'  for  any  reason, 
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Programming  With  Restart  Vectors 


The  Restart  instruction  (RST)  provides  the  assembly  language  programmer 
with  the  ability  to  call  a  subroutine  with  a  one-byte  call.  If  a  routine  is  called 
many  times  by  a  program,  the  amount  of  space  that  is  saved  by  using  the  RST 
instruction  (instead  of  a  three-byte  CALL)  can  be  significant. 

In  TRSDOS  a  RST  instruction  is  also  used  to  interface  to  the  operating  system , 
The  system  uses  RST  28H  for  supervisor  calls  RSTS  00H,  30H,  and  38H  are 
for  the  system's  internal  use, 

RSTs  08H,  10H,  18H,  and  20H  are  available  for  your  use.  Caution:  Some  pro- 
grams, such  as  BASIC,  may  use  some  of  these  RSTs, 

Each  RST  instruction  calls  the  address  given  in  the  operand  field  of  the  instruc- 
tion. For  example,  RST  18H  causes  the  system  to  push  the  current  program 
counter  address  onto  the  stack  and  then  set  the  program  counter  to  address 
0018H,  RST  20H  causes  a  jump  to  location  O020H,  and  so  on., 

Each  RST  has  three  bytes  reserved  for  the  subroutine  to  use.,  If  the  subroutine 
will  not  fit  in  three  bytes,  then  you  should  code  a  jump  instruction  (JP)  to  where 
the  subroutine  is  located  At  the  end  of  the  subroutine,  code  a  return  instruction 
(RET)  Control  is  then  transferred  to  the  instruction  that  follows  the  RST 

For  example,  suppose  you  want  to  use  RST  18H  to  call  a  subroutine  named 
"ROUTINE,"  The  following  routine  loads  the  restart  vector  with  a  jump  instruc- 
tion and  saves  the  old  contents  of  the  restart  vector  for  later  use 


SETRST: 

LD 

IX»001BH 

iRestart  area  address 

LD 

IYiRDATA 

iDat a  area  add  ress 

LD 

B  f3 

i N  u m b  e  r  of  bytes  to  m  o  u e 

LOOP: 

LD 

A  t  (  I X  ) 

5 R  e  a  d  a  b  v  t  e  from 
i  res  t  a  rt  area 

LD 

C  t  (  I Y  ) 

i  R  e  a  d  a  byte  f  r  o  m  data 
i  a  rea 

LD 

(IX)  »C 

! S t o  r e  this  byte  in 
»  restart  area 

LD 

(  I  Y  )  >  A 

IStore  this  byte  in  data 
i  a  rea 

INC 

IX 

{Increment  restart  area 
Ipointer 

INC 

IY 

i  I  n  c  r  e  hi  e  n  t  data  area 
ipointer 

DJIMZ 

LOOP 

! L o o p  till  3  bytes  moued 

RET 

» R e t u r n  w hen  do n e 

RDftTA: 

DEFB 

0C3H 

i  Jump  instruction  ( JP ) 

DEFN 

ROUTINE 

i Operand  (name  of 

{subroutine) 
Before  exiting  the  program,  calling  the  above  routine  again  puts  the  original 
contents  of  the  restart  vector  back  in  place 


KFLAG$  fBREM).  (paDse).  and  dJDH) 

Interfacing 


KFLAG$  contains  three  bits  associated  with  the  keyboard  functions  of  BREAK, 
PAUSE  ((SHIFT)  QD),  and  ENTER,,  A  task  processor  interrupt  routine  (called  the 
KFLAG$  scanner)  examines  the  physical  keyboard  and  sets  the  appropriate 
KFLAG$  bit  if  any  of  the  conditions  are  observed.  Similarly,  the  RS-232C  driver 
routine  also  sets  the  KFLAG$  bits  if  it  detects  the  matching  conditions  being 
received. 
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Many  applications  need  to  detect  a  PAUSE  or  BREAK  while  they  are  running. 
BASIC  checks  for  these  conditions  after  each  logical  statement  is  executed 
(that  is,  at  the  end  of  a  line  or  at  a  ":").  That  is  how,  in  BASIC,  you  can  stop  a 
program  with  the  (break]  key  or  pause  a  listing. 

One  method  of  detecting  the  condition  in  previous  TRSDOS  operating  systems 
was  to  issue  the  @KBD  supervisor  call  to  check  for  BREAK  or  PAUSE 
(rJHIEDGD),  ignoring  all  other  keys.  Unfortunately,  this  caused  keyboard  type- 
ahead  to  be  ineffective;  the  @KBD  SVC  flushed  out  the  type-ahead  buffer  if 
any  other  keystrokes  were  stacked  up. 

Another  method  was  to  scan  the  keyboard,  physically  examining  the  keyboard 
matrix.  An  undesirable  side  effect  of  this  method  was  that  type-ahead  stored  up 
the  keyboard  depression  for  some  future  unexpected  input  request.  Examining 
the  keyboard  directly  also  inhibits  remote  terminals  from  passing  the  BREAK  or 
PAUSE  condition. 

In  TRSDOS  Version  6,  the  KFLAG$  scanner  examines  the  keyboard  for  the 
BREAK,  PAUSE,  and  ENTER  functions.  If  any  of  these  conditions  are  detected, 
appropriate  bits  in  the  KFLAG$  are  set  (bits  0, 1,  and  2  respectively), 

Note  that  the  KFLAG$  scanner  only  sets  the  bits,  It  does  not  reset  them 
because  the  "events"  would  occur  too  fast  for  your  program  to  detect.  Think  of 
the  KFLAG$  bits  as  a  latch.  Once  a  condition  is  detected  (latched),  it  remains 
latched  until  something  examines  the  latch  and  resets  it — a  function  to  be  per- 
formed by  your  KFLAG$  detection  routine 

Under  Version  6.2,  you  can  use  the  (aCKBRKC  SVC,  SVC  106,  to  see  if  the 
BREAK  key  has  been  pressed,  If  a  BREAK  condition  exists,  (a  CKBRKC  resets 
the  break  bit  of  KFLAG$ 

For  illustration,  the  following  example  routine  uses  the  BREAK  and  PAUSE 
conditions: 


KFLAG$ 

EQU 

10 

§FLAGS 

EOU 

101 

§K6D 

EQU 

8 

SKEY 

EQU 

1 

@PAUSE 

EQU 

IS 

CKPAWS 

LD 

A  t§FLAGS 

i G e t  F 1  a  2  s  pointer 

RST 

28H 

Hn to  register  I Y 

LD 

A»(IY+KFLAG$) 

iGet  the  KFLAG$ 

RRCA 

i  B  i  t  0  to  carry 

JP 

CiGOTBRK 

jGo  on  BREAK 

RRCA 

i  B  i  t  1  to  carrv 

RET 

NC 

i  R  e  t  u  r  n  if  no  pause 

CALL 

RESKFL 

;  1?  e  s  e  t  the  flaS 

PUSH 

DE 

FLUSH 

LD 

A  »@KBD 

iFlush  type-ahead 

RST 

28H 

i  buf f e  r  while 

JR 

Z>FLUSH 

iidnorin£  errors 

POP 

DE 

PROMPT 

PUSH 

DE 

LD 

A  ,@KEY 

5 W a i  t  on  K  e  y  entry 

RST 

28H 

POP 

DE 

CP 

80H 

i  A b o  r t  on  dmEM) 

JP 

Z»G0TBRK 

CP 

60H 

ignore  PAUSE  i 

JR 

Z  (PROMPT 

ielse  .  .  ♦ 

RESKFL 

PUSH 

HL 

ireset  KFLAG$ 

PUSH 

AF 

LD 

A*@FLAGS 

iGet  f  1  a  tf  s  pointer 

RST 

28H 

linto  register  IV 

RESKFL! 

LD 

A*(IY+KFLAG$) 

iGet  the  flaS 

AND 

E3F8H 

iStrip  ENTER* 
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LD 

(IY+KFLAG$) ,A 

5PAUSE*  BREAK 

PUSH 

BC 

LD 

B'tlB 

LD 

A»£PAUSE 

iPause  a  while 

RST 

28H 

POP 

BC 

LD 

A»(IY+KFLAG*) 

?  C  h  e  c  K  if  finger  is 

AND 

3 

i  s  t  i  1 1  on  Key 

JR 

NZ  »RESKFL1 

?  R  e  s  e  t  it  again 

p0p 

AF 

tResto  re  re  tf iste  rs 

POP 

HL 

? and  exit 

RET 

The  best  way  to  explain  this  KFLAG$  detection  routine  is  to  take  it  apart  and 
discuss  each  subroutine.,  The  first  piece  reads  the  KFLAG$  contents: 


KFLAG$ 

EOU 

10 

CKPAWS 

LD 

A>§FLAG5 

5  G  e  t  Flags  pointer 

RST 

Z8H 

!  i  n  t  o  register  IY 

LD 

A»(IY+KFLAG$) 

iGet  the  KFLAG$ 

RRCA 

9 B i  t  0  to  carry 

JP 

CiGOTBRK 

iGo  on  BREAK 

RRCA 

! B i t  1  to  carry 

RET 

NC 

i Re  turn  if  no  pause 

The  ©FLAGS  SVC  obtains  the  fiags  pointer  from  TRSDOS,  Note  that  if  your 
application  uses  the  IY  index  register,  you  should  save  and  restore  it  within  the 
CKPAWS  routine.  (Alternatively,  you  could  use  @FLAGS  to  calculate  the  loca- 
tion of  KFLAG$,  use  register  HL  instead  of  IY,  and  place  the  address  into  the  LD 
instructions  of  CKPAWS  at  the  beginning  of  your  application.) 

The  first  rotate  instruction  places  the  BREAK  bit  into  the  carry  flag.  Thus,  if  a 
BREAK  condition  is  in  effect,  the  subroutine  branches  to  "GOTBRK,"  which  is 
your  BREAK  handling  routine., 

If  there  is  no  BREAK  condition,  the  second  rotate  places  what  was  originally  in 
the  PAUSE  bit  into  the  carry  flag.  If  no  PAUSE  condition  is  in  effect,  the  routine 
returns  to  the  caller, 

This  sequence  of  code  gives  a  higher  priority  to  BREAK  (that  is,  if  both  BREAK 
and  PAUSE  conditions  are  pending,  the  BREAK  condition  has  precedence). 
Note  that  the  GOTBRK  routine  needs  to  clear  the  KFLAG$  bits  after  it  services 
the  BREAK  condition,,  This  is  easily  done  via  a  call  to  RESKFL 

The  next  part  of  the  routine  is  executed  on  a  PAUSE  condition: 

iReset  the  flag 

FLUSH    LD    Af@KBD        iFlush  type-ahead 

i  b  u  f  f  e  r  while 
^ignoring  errors 

First  the  KFLAG$  bits  are  reset  via  the  call  to  RESKFL  Next,  the  routine  takes 
care  of  the  possibility  that  type-ahead  is  active.  If  it  is,  the  PAUSE  key  was  prob- 
ably detected  by  the  type-ahead  routine  and  so  is  stacked  in  the  type-ahead 
buffer  also  To  flush  out  (remove  all  stored  characters  from)  the  type-ahead 
buffer,  @KBD  is  called  until  no  characters  remain  (an  NZ  is  returned) 

Now  that  a  PAUSEd  state  exists  and  the  type-ahead  buffer  is  cleared,  the  rou- 
tine waits  for  a  key  input: 


CALL 

RESKFL 

PUSH 

DE 

LD 

Af@KBD 

RST 

28H 

JR 

Z»FLUSH 

POP 

DE 

PROMPT 


PUSH 

DE 

LD 

AtOKEY 

RST 

28H 

POP 

DE 

CP 

80H 

JP 

Z  ^GOTBRK 

?  W a i  t    on    Key    entry 


i  A b o  r t    on 
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CP 

B0H 

Udnore    PAUSE  5 

JR 

Z* PROMPT 

islse     ♦     »     . 

The  PROmPT 

routine  < 

accepts  a  BREAK  and  branches  to  your  BREAK  nan- 

dling  routine  It  ignores  repeated  PAUSE  (the 

60H)„  Any  other  character  causes 

it  to  fall  through 

to  the  following  routine  which  clears  the  KFLAG$: 

RESKFL 

PUSH 

HL 

Ireset    KFLAG$ 

PUSH 

AF 

LD 

A>@FLAGS 

SGetflads    pointer 

RST 

28H 

Sinto    register    IV 

REBKFLi 

LD 

A»(IY+KFLAG$) 

iGet    the    f  la* 

AND 

0F8H 

!St rip    ENTER  t 

LD 

(IY+KFLAG*) *A 

i PAUSE,    BREAK 

PUSH 

BC 

LD 

B»iS 

LD 

A t§PAUSE 

iPause    a    while 

RST 

28H 

POP 

BC 

LD 

A»UY  +  KFLAG$) 

iChecK    if    finder    is 

AND 

3 

5  5 1  i  1 1    on    Kev 

JR 

NZ  .RE5KFL1 

iReset    it    a 3 a i n 

POP 

AF 

iResto  re    redi  ste  rs 

RET 


The  RESKFL  subroutine  should  be  called  when  you  first  enter  your  application. 
This  is  necessary  to  clear  the  flag  bits  that  were  probably  in  a  "set"  condition 
This  "primes"  the  detection.  The  routine  should  also  be  called  once  a  BREAK, 
PAUSE,  or  ENTER  condition  is  detected  and  handled  (You  need  to  deal  with 
the  flag  bits  for  only  the  conditions  you  are  using.) 


Interfacing  to  @iCNFG 


With  the  TRSDOS  library  command  SYSGEN,  many  users  may  wish  to  SYS- 
GEN  the  RS-232C  driver.  Before  doing  that,  the  RS-232C  hardware  (UART, 
Baud  Rate  Generator,  etc.)  must  be  initialized..  Simply  using  the  SYSGEN  com- 
mand with  the  RS-232C  driver  resident  is  not  enough;  some  initialization 
routine  is  necessary,  The  @ICNFG  (Initialization  CoNFiGuration)  vector  is 
included  in  TRSDOS  to  provide  a  way  to  invoke  a  routine  to  initialize  the  RS- 
232C  driver  when  the  system  is  booted.  It  also  provides  a  way  to  initialize  the 
hard  disk  controller  at  power-up  (required  by  the  Radio  Shack  hard  disk 
system). 

The  final  stages  of  the  booting  process  loads  the  configuration  file  CONFIG/ 
SYS  if  it  exists.  After  the  configuration  file  is  loaded,  an  initialization  subroutine 
CALLs  the  @ICNFG  vector  Thus,  any  initialization  routine  that  is  part  of  a 
memory  configuration  can  be  invoked  by  chaining  into  @ICNFG. 

If  you  need  to  configure  your  own  routine  that  requires  initialization  at  power-up, 
you  can  chain  into  @ICNFG.  The  following  procedure  illustrates  this  link,  The 
first  thing  to  do  is  to  move  the  contents  of  the  @ICNFG  vector  into  your  initiali- 
zation routine: 


LD 

A^FLAGS 

iGet    f 1  a  *  s    pointer 

RST 

28H 

i  i  n  t  o    register    I Y 

LD 

A»(IY+28) 

iGet    opcode 

LD 

(LINK)  fA 

LD 

L»(IY+29) 

iGet    address    LOW 

LD 

H»(IY+30) 

iGet    address    HIGH 

LD 

(LINK+1)  t 

HL 

This  subroutine  does  this  by  transferring  the  3-byte  vector  to  your  routine.  You 
then  need  to  relocate  your  routine  to  its  execution  memory  address,  Once  this 
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is  done,  transfer  the  relocated  initialization  entry  point  to  the  @ICNFG  vector  as 
a  jump  instruction: 


LD 

HL»INIT 

!Get  ( rel ocated ) 

LD 

(IY+29) 

,L 

Unit  address 

LD 

(IY+30) 

fH 

LD 

A,0C3H 

! S e t  JP  instruction 

LD 

(IY+2B) 

,A 

If  you  need  to  invoke  the  initialization  routine  at  this  point,  then  you  can  use: 

CALL  ROUTINE        j I n v o K e  your  routine 

Your  initialization  routine  would  be  unique  to  the  function  it  was  to  perform,  but 
an  overall  design  would  look  like  this: 

INIT     CALL  ROUTINE        iStart  of  init 

LINK     DEFS  3  (Continue  on 

ROUTINE  • 

your  initialization    routine 

RET 

After  linking  in  your  routine,  perform  the  SYSGEN,  If  you  have  followed  these 
procedures,  your  routine  will  be  invoked  every  time  you  start  up  TRSDOS, 


Interfacing  to  @KITSK 


Background  tasks  can  be  invoked  in  one  of  two  ways.  For  tasks  that  do  not 
require  disk  I/O,  you  can  use  the  RTC  (Real  Time  Clock)  interrupt  and  one  of 
the  12  task  slots  (or  other  external  interrupt).  For  tasks  that  require  disk  I/O,  you 
can  use  the  keyboard  task  process. 

At  the  beginning  of  the  TRSDOS  keyboard  driver  is  a  call  to  @KITSK„  This 
means  that  any  time  that  @KBD  is  called,  the  @KITSK  vector  is  also  called, 
(The  type-ahead  task,  however,  bypasses  this  entry  so  that  @KITSK  is  not 
called  from  the  type-ahead  routine)  Therefore,  if  you  want  to  interface  a  back- 
ground routine  that  does  disk  I/O,  you  must  chain  into  @KITSK, 

The  interfacing  procedure  to  @KITSK  is  identical  to  that  shown  in  the  section 
"Interfacing  to  @ICNFG,"  except  that  IY  +  31  through  IY  +  33  is  used  to  refer- 
ence the  @KITSK  vector.  You  may  want  to  start  your  background  routine  with: 


START 

CALL 

ROUTINE 

!  I  n  u  o  K  e  t  a  s  K 

LINK 

DEFS 

3 

!For  @KITSK  hooK 

ROUTINE 

EOU 

$ 

iStart  of  the  task 

Be  aware  of  one  major  pitfall.,  The  @KBD  routine  is  invoked  from  @CMNDI  and 
@CMNDR  (which  is  in  SYS1/SYS),  This  invocation  is  from  the  @KEYIN  call, 
which  fetches  the  next  command  line  after  issuing  the  "TRSDOS  Ready"  mes- 
sage. If  your  background  task  executes  and  opens  or  closes  a  file  (or  does  any- 
thing to  cause  the  execution  of  a  system  overlay  other  than  SYS1),  then  SYS1 
is  overwritten  by  SYS2  or  SYS3.,  When  your  routine  finishes,  the  @KEYIN  han- 
dler tries  to  return  to  what  called  it — SYS1,  which  is  no  longer  resident  There- 
fore, any  task  chained  to  @KITSK  which  causes  a  resident  SYS1  to  be  over- 
written must  reload  SYS1  before  returning 

You  can  use  the  following  code  to  reload  SYS1  if  SYS1  was  resident  prior  to 
your  task's  execution: 

?Ge  t    f  1  ads    pointer 
i  i n t o    register    I Y 
iGet     resident    ouer- 
1 1  a  v    and    r  e  m  o  v e 
!  t  h  e    entry    code 
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ROUTINE  LD 

A,§FLAGS 

RST 

28H 

LD 

A»(IY-i) 

AND 

8FH 

LD 

(OLDSYS+1) 

rest 

of  your 

tasK 

EXIT 

EOU 

$ 

0LD3V5 

LD 

A  *  ED 

5Get  old  overlay  « 

CP 

83H 

iWas  it  SYSi? 

RET 

NZ 

iReturn  if  notl  else 

RST 

28H 

iGet  SVSi  per  re<*.  A 
!  ( no  RET  needed ) 

Interfacing  to  the  Task  Processor 


This  section  explains  how  to  integrate  interrupt  tasks  into  your  applications, 

One  of  the  hardware  interrupts  in  the  TRS-80  is  the  real  time  clock  (RTC).  The 
RTC  is  synchronized  to  the  AC  line  frequency  and  puises  at  60  pulses  per  sec- 
ond, or  once  every  16.67  milliseconds.  (Computers  operating  with  50  Hz  AC 
use  a  50  puises  per  second  RTC  interrupt,  In  this  case,  all  time  relationships 
discussed  in  this  section  should  be  adjusted  to  the  50  Hz  base.) 

A  software  task  processor  manages  the  RTC  interrupt  in  performing  back- 
ground tasks  necessary  to  specific  functions  of  TRSDOS  (such  as  the  time 
clock,  blinking  cursor,  and  so  on).  The  tasK  processor  aiiows  up  to  12  individual 
tasks  to  be  performed  on  a  "time-sharing"  basis. 

These  tasks  are  assigned  to  "task  slots"  numbered  from  0  to  11  Slots  0-7  are 
considered  "low  priority"  tasks  (executing  every  266  67  milliseconds).  Slots  8- 
10  are  medium  priority  tasks  (executing  every  33.33  milliseconds).  Slot  11  is  a 
high  priority  task  (executing  every  16,66  milliseconds  SYSTEM  (FAST)  or  33.33 
milliseconds  SYSTEM  (SLOW)).  Task  slots  3,  7,  9,  and  10  are  reserved  by  the 
system  for  the  ALIVE,  TRACE,  SPOOL,  and  TYPE-AHEAD  functions, 
respectively, 

TRSDOS  maintains  a  Task  Control  Block  Vector  Table  (TCBVT)  which  contains 
12  vectors,  one  for  each  of  the  12  task  slots.  TRSDOS  contains  five  supervisor 
calls  that  manage  the  task  vectors.  The  five  SVCs  and  their  functions  are: 

@CKTSK  Checks  to  see  whether  a  task  slot  is  unused  or  active 

@ADTSK  Adds  a  task  to  the  TCBVT 

@RMTSK  Removes  a  task  from  the  TCBVT 

@KLTSK  Removes  the  currently  executing  task 

@RPTSK  Replaces  the  TCB  address  for  the  current  task 

The  TRSDOS  Task  Control  Block  Vector  Table  contains  vector  pointers.  Each 
TCBVT  vector  points  to  an  address  in  memory,  which  in  turn  contains  the 
address  of  the  task,,  Thus,  the  tasks  themselves  are  indirectly  addressed. 

When  you  are  programming  a  task  to  be  called  by  the  task  processor,  the  entry 
point  of  the  routine  needs  to  be  stored  in  memory.  If  you  make  this  storage  loca- 
tion the  beginning  of  a  Task  Controi  Block  (TCB),  the  reason  for  indirect  vector- 
ing of  interrupt  tasks  will  become  more  clear  Consider  an  example  TCB: 

MYTCB  DEFW  MYTASK 

COUNTER  DEFB  15 

TEMPY  DEFS  1 

MYTASK  RET 

This  is  a  useless  task,  since  the  only  thing  it  does  is  return  from  the  interrupt. 
However,  note  that  a  TCB  location  has  been  defined  as  "MYTCB"  and  that  this 
location  contains  the  address  of  the  task  A  few  more  data  bytes  immediately 
following  the  task  address  storage  have  also  been  defined. 

Upon  entry  to  a  service  routine,  index  register  IX  contains  the  address  of  the 
TCB.  You  can  therefore  address  any  TCB  data  using  index  instructions.  For 
example,  you  could  use  the  instruction  "DEC  (IX +  2)"  to  decrement  the  value 
contained  in  COUNTER  in  the  above  routine. 
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Here  is  the  routine  expanded  slightly: 


MYTCB 

DEFW 

MYTASK 

COUNTER 

DEFB 

15 

TEMPY 

DEFB 

0 

MYTASK 

DEC 

(IX+2) 

RET 

NZ 

LD 

(IX+2)  #15 

RET 

This  version  makes  use  of  the  counter  Each  time  the  task  executes,  the  counter 
is  decremented,  When  the  count  reaches  zero,  the  counter  is  restored  to  its 
original  value, 

In  order  to  be  executed,  all  tasks  must  be  added  to  the  TCBVT  The  @ADTSK 
supervisor  call  does  this  For  the  above  routine,  assume  the  task  slot  chosen  is 
low-priority  slot  2.  You  can  ascertain  that  slot  2  is  available  for  use  by  usinq  the 
@CKTSK  SVC  as  follows: 


LD 

C#2 

iRef e rence  slot  2 

LD 

A  #26 

5 Set  for  SCKTSK  SVC 

RST 

28H 

!An  "NZ"  indication 

JP 

NZ#INUSE 

S s a y s  that  the  slot 
!  b  e  i  n 3  used* 

Once  you  determine  that  the  slot  is  available  {that  is,  not  being  used  by  some 
other  task),  you  can  add  your  task  routine.  The  following  code  adds  this  task  to 
theTCBVT: 


LD 

DE»MYTCB 

!  Point  to  the  TCB 

LD 

C#2 

{Reference  slot  2 

LD 

A  #23 

iSet  for  §ADTSK  SVC 

RST 

28H 

!  Issue  the  SVC 

The  above  program  lines  point  register  DE  to  the  TCB,  load  the  task  slot  num- 
ber into  register  C,  and  then  issue  the  @ADTSK  supervisor  call.,  (f  you  want  this 
task  to  run  regardless  of  what  is  in  memory,  you  can  place  it  in  high  memory  (of 
bank  0)  and  protect  it  by  moving  HIGH$  below  it  via  the  (a>HIGH$  supervisor 
call, 

Once  a  task  has  been  activated,  it  is  sometimes  necessary  to  deactivate  it.  You 
can  do  this  in  two  ways.  The  most  common  way  is  to  use  the  @RMTSK  super- 
visor call: 


LD 

C»2 

{Designate  the  tasK 

1  5  1  0  t 

LD 

A  #30 

iSet  for  SRMTSK  SVC 

RST 

28H 

ilssue  the  SVC 

You  identify  the  task  slot  to  remove  by  placing  a  value  in  register  C,  and  then 
you  issue  the  supervisor  call. 

You  can  use  another  method  if  you  want  to  remove  the  task  while  it  is  being 
executed.  Examine  the  routine  modified  as  follows: 


MYTCB 

DEFW 

MYTASK 

COUNTER 

DEFB 

10 

TEMPY 

DEFB 

0 

MYTASK 

DEC 

(IX+2) 

RET 

NZ 

LD 

A  t32 

■  Set  for  SKLTSK  SVC 

RST 

28H 

ilssue  the  SVC 

The  @KLTSK  supervisor  call  removes  the  currently  executing  task  from  the 
TCBVT  The  system  does  not  return  to  your  routine,  but  continues  as  if  you  had 
executed  a  RET  instruction.,  For  this  reason,  the  @KLTSK  SVC  should  be  the 
last  instruction  you  want  executed.  In  this  example,  MYTASK  decrements  the 
counter  by  one  on  each  entry  to  the  task.  When  the  counter  reaches  zero,  the 
task  is  removed  from  slot  2, 
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The  last  task  processor  supervisor  call  is  @RPTSK,  The  @RPTSK  function 
updates  the  TCB  storage  vector  (the  vector  address  in  your  Task  Control  Block) 
to  be  the  address  immediately  following  the  @RPTSK  SVC  instruction,  As  with 
@KLTSK,  the  system  does  not  return  to  your  service  routine  after  the  SVC  is 
made,  but  continues  on  with  the  task  processor  The  following  example  illus- 
trates how  @RPTSK  can  be  used  in  a  program: 


ORG 

9000H 

iADTSK 

EQU 

29 

@RPTSK 

EQU 

31 

GRMTSK 

EQU 

30 

BEX  IT 

EQU 

22 

@UDCTL 

EQU 

15 

5EGIN 

LD 

DE,TCB 

i Point  to  TCB 

LD 

C»0 

iand  add  the  task 

LD 

A*§ADTSK 

i  to  slot  0 

RST 

28H 

LD 

AiGEXIT 

.Exit  to  TRSDOS 

RST 

28H 

TCB 

DEFW 

TASK 

COUNTER 

DEFB 

15 

TASKA 

LD 

A*@RPTSK 

iReplace  current 

RST 

28H 

UasK  with  TASKA 

TASK 

LD 

BC027CH 

i  P  u  t  a  character 

LD 

HL»004FH 

Sat  Row  0  t    Col  .  7S 

LD 

A»SVDCTL 

RST 

28H 

DEC 

(IX+Z) 

iDecrement  the  counter 

RET 

NZ 

land  return  if  not 

LD 

(IX+2)  »15 

!  e  k  p  i  r  e  d  i  else  reset 

LD 

A»§RPTSK 

iReplace  the  previous 

RST 

28H 

itasK  with  TASKB 

TASKB 

LD 

BC.022DH 

)  P  u  t  a  character 

LD 

HL ,004FH 

iat  Raw  Bt  Col.  79 

LD 

AjSMDCTL 

RST 

28H 

DEC 

(IX+2) 

RET 

NZ 

LD 

(IX+2)  *15 

JR 

TASKA 

END 

BEGIN 

This  task  routine  contains  no  method  of  relocating  it  to  protected  RAM,  The 
statements  starting  at  the  label  BEGIN  add  the  task  to  TCBVT  slot  0  and  return 
to  TRSDOS  Ready.  The  task  contains  a  four-second  down  counter  and  a  rou~ 
tine  to  put  a  character  in  video  RAM  (80th  character  of  Row  0),  At  four-second 
intervals,  the  character  toggles  between  l|'  and  '-'.  This  is  done  by  using  the 
@RPTSK  SVC  to  toggle  the  execution  of  two  separate  routines  which  perform 
the  character  display. 

TRSDOS  uses  bank-switched  memory.  In  order  to  properly  control  and  man- 
age this  additional  memory,  certain  restrictions  are  placed  on  tasks.  All  tasks 
must  be  placed  either  in  low  memory  (addresses  X'0000'  through  X7FFF')  or 
in  bank  zero  of  high  memory  (addresses  X'8000'  through  X'FFFF')  The  task 
processor  always  enables  bank  zero  when  performing  background  tasks.  The 
assembly  language  programmer  must  ensure  that  tasks  are  placed  in  the  cor- 
rect memory  area. 


Interfacing  RAM  Banks  1  and  2 


The  proper  use  of  the  RAM  bank  transfer  techniques  described  here  requires  a 
high  degree  of  skill  in  assembly  language  programming.  This  section  on  bank 
switching  is  intended  for  the  professional, 
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The  TRS-80  Mode!  4  can  optionally  support  a  second  set  of  64K  RAM,  bringing 
the  total  RAM  to  128K.  TRSDOS  designates  this  extra  64K  RAM  as  two  banks 
of  32K  RAM  each,  which  are  banks  1  and  2  of  bank-switched  RAM,  The  upper 
32K  of  standard  RAM  is  designated  bank  0  At  any  one  time,  only  one  of  the 
banks  is  resident.  The  resident  bank  is  always  addressed  at  X'8000'  through 
X'FFFF'  When  a  bank  transfer  is  performed,  the  specified  bank  becomes 
addressable  and  the  previous  bank  is  no  longer  available.  Since  memory 
refresh  is  performed  on  all  banks  at  all  times,  nothing  in  the  previously  resident 
bank  is  altered  during  whatever  time  it  is  not  addressable  (that  is,  not  resident). 

You  can  access  this  additional  RAM  by  means  of  the  @BANK  supervisor  call 
(SVC  1 02).,  When  you  power  up  your  computer  or  press  reset,  TRSDOS  looks 
to  see  which  banks  of  RAM  are  installed  in  your  machine.,  TRSDOS  maintains 
a  bit  map  in  one  byte  of  storage,  with  each  bit  representing  one  of  the  banks  of 
RAM  This  byte  is  called  "Bank  Available  RAM"  (BAR),  and  its  information  is  set 
when  you  boot  TRSDOS  Bit  0  corresponds  to  bank  0,  bit  1  corresponds  to 
bank  1,  and  so  on  up  to  bit  7  From  a  hardware  standpoint,  the  Model  4  has  a 
maximum  of  three  banks.,  You  have  either  bank  0  only  (a  64K  machine),  or 
banks  0-2  (a  128K  machine). 

Another  bit  map  is  used  to  indicate  whether  a  bank  is  reserved  or  available  for 
use.  This  byte  is  called  the  "Bank  Used  RAM"  (BUR)  Again,  bit  0  corresponds 
to  bank  0,  bit  1  to  bank  1,  and  so  on,  TRSDOS  design  supports  the  use  of  banks 
1  and  2  primarily  for  data  storage  (for  example,  a  spool  buffer,  Memdisk,  eta). 
The  management  of  any  memory  space  within  a  particular  bank  of  RAM 
(excluding  bank  0)  is  the  responsibility  of  the  application  program  "reserving"  a 
particular  bank 

TRSDOS  requires  that  any  device  driver  or  filter  that  is  relocated  to  high  mem- 
ory (X'8000'  through  X'FFFF')  reside  in  bank  0  The  TRSDOS  device  handler 
always  invokes  bank  0  upon  execution  of  any  byte  I/O  service  request  (@PUT, 
@GET,  @CTL,  as  well  as  other  byte  I/O  SVCs  that  use  @PUT/@GET/@CTL). 
This  ensures  that  any  filter  or  driver  attached  to  the  device  in  question  will  be 
available.  If  a  RAM  bank  other  than  0  was  resident,  it  is  restored  upon  return 
from  the  device  handler  This  ensures  that  device  I/O  is  never  impacted  by  bank 
switching 

TRSDOS  also  requires  that  ail  interrupt  tasks  reside  in  bank  0  or  low  memory 
(X'0000'  through  X7FFF')..  The  interrupt  task  processor  always  enables  bank  0 
and  restores  whatever  bank  was  previously  resident  An  interrupt  task  may  per- 
form a  bank  transfer  from  0  to  another  bank  provided  the  necessary  linkage 
and  stack  area  is  used.  This  is  discussed  in  more  detail  later 

All  bank  transfer  requests  must  be  performed  using  the  @BANK  SVC,  This 
SVC  provides  four  functions,  three  of  which  are  interrogatory  and  one  of  which 
performs  the  actual  bank  switching 

As  mentioned  previously,  the  contents  of  banks  other  than  0  are  managed  by 
the  application,  not  by  TRSDOS,  Therefore,  the  application  needs  a  way  of  find- 
ing out  if  any  given  bank  is  available.  For  example,  if  an  application  wants  to 
reserve  use  of  bank  1,  it  must  first  check  to  see  if  bank  1  is  free  to  use,  This  is 
done  by  using  function  2  as  follows: 

■Specify  bank  1 

i Check  BUR  if  bank  in  use 

iSet  @BANK  SVC  (102) 

? N2  if  bank  already  in  u s e 

Note  that  the  return  condition  (NZ  or  2)  shows  whether  or  not  you  can  use  the 
specified  bank  (it  may  not  even  be  installed) 

If  the  specified  bank  is  available,  you  then  need  to  reserve  it.  Do  this  by  using 
function  3  as  follows: 


LD 

C,i 

LD 

B»2 

LD 

A»@BANK 

RST 

28H 

JR 

NZ tINUSE 

LD 

C»l 

iSpeci  f  v    bank  1 

LD 

B,3 

iSet  BUR  to  show 
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LD      Ai@BANK      »Set  0BANK  SMC  (102) 

RST     28H 

JR      NZjERROR 

You  must  check  for  an  error  by  examining  the  Z  flag.  In  general  (discounting  a 
system  error),  an  NZ  condition  returned  means  that  the  specified  bank  is 
already  in  use.  If  you  had  performed  a  function  2  (testing  to  see  if  the  bank  was 
available)  and  got  a  not-in-use  indication,  but  got  an  NZ  condition  on  function 
3,  then  the  @BANK  SVC  routine  has  been  altered  and  is  probably  unusable 

When  an  application  no  longer  requires  a  memory  bank,  it  can  return  the  bank 
to  a  "free"  state  by  using  function  1  as  follows: 


LD 

C»l 

iSpecif y  banK  1 

LD 

B  il 

iSet  BUR  to  show  f  ree 

LD 

Af§BANK 

iSet  0BANK  SUC  (102) 

RST 

28H 

No  error  condition  is  checked,  as  none  is  returned  by  TRSDOS.  If  you  should 
mistakenly  use  function  1  with  a  bank  that  is  nonexistent,  an  error  is  returned  if 
you  try  to  invoke  the  nonexistent  bank, 

To  find  out  which  bank  is  resident  at  any  time,  use  function  4  as  follows: 


LD 

b  ,a 

5Mhich  banK  is 

resident? 

LD 

A*§BANK 

iSet  §BANK  SYC 

(  102) 

RST 

28H 

The  current  bank  number  is  returned  in  register  A. 

To  exchange  the  current  bank  with  the  specified  bank,  use  function  0.  Since  a 
memory  transfer  takes  place  in  the  address  range  X'8000*  through  X'FFFF; 
the  transfer  cannot  proceed  correctly  if  the  stack  pointer  (SP)  contains  a  value 
that  places  the  stack  in  that  range.  @BANK  inhibits  function  0  and  returns  an 
SVC  error  if  the  stack  pointer  violates  this  condition 

A  bank  can  be  used  purely  as  a  data  storage  buffer.  The  application's  routines 
for  invoking  and  indexing  the  bank  switching  probably  reside  in  the  user  range 
X'3000'  through  X7FFF  As  an  example,  the  following  code  invokes  a  previ- 
ously tested  and  reserved  bank  (via  functions  2  and  3),  accesses  the  buffer, 
and  then  restores  the  previous  bank: 


LD 

Cil 

iSpecify  banK  i 

LD 

B,0 

iBrina  up  banK 

LD 

A*§BANK 

iSet  @BANK  SUC  (102) 

RST 

28H 

JR 

NZJERROR 

lErrar  t  rap 

PUSH 

BC 

iSaue  old  banK  data 

your 

code  to  access 

the  buffer  region 

POP 

BC 

iRecoMer  old  banK  da 

LD 

A*@BANK 

SSet  @BANK  SMC  (102) 

RST 

28H 

JR 

NZ  tERROR 

lError  t  rap 

Note  that  the  @BANK  function  0  conveniently  returns  a  zero  in  register  B  to 
effect  a  function  0  later,  as  well  as  provides  the  old  bank  number  in  register  C 
This  means  that  you  only  have  to  save  register  pair  BC,  pop  it  when  you  want 
to  restore  the  previous  bank,  and  then  issue  the  ©BANK  SVC. 

Suppose  you  want  to  transfer  to  another  bank  from  a  routine  that  is  executing 
in  high  memory.  (Recall  that  the  only  limitation  is  that  the  stack  must  not  be  in 
high  memory.)  The  @BANK  SVC  function  0  provides  a  technique  for  automat- 
ically transferring  to  an  address  in  the  new  bank  This  technique  is  called  the 
transfer  function.  It  relies  on  the  assumption  that  since  you  are  managing  the 
entire  32K  bank  1  or  2,  your  application  should  know  exactly  where  it  needs  to 
transfer  (that  is,  where  the  application  originally  placed  the  code  to  execute). 
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The  code  to  perform  a  bank  transfer  is  similar  to  the  above  example.  Register 
pair  HL  is  loaded  with  the  transfer  address.  Register  C,  which  contains  the  num- 
ber of  the  bank  to  invoke,  must  have  its  high  order  bit  (bit  7)  set.  After  the  spec- 
ified bank  is  enabled,  control  is  passed  to  the  transfer  address  that  is  in  HL. 
Upon  entry  to  your  routine  in  the  new  bank  (referred  to  here  as  "PROGB"),  reg- 
ister HL  will  contain  the  old  return  address  so  that  PROGB  will  know  where  to 
return  transfer,  Register  C  will  also  contain  the  old  bank  number  with  bit  7  set 
and  register  B  will  contain  a  zero.  This  register  set-up  provides  for  an  easy 
return  to  the  routine  in  the  old  bank  that  invoked  the  bank  transfer  An  illustra- 
tion of  the  transfer  code  follows: 


LD 

C»l 

i S p e o  i  f  y  banK  1 

LD 

B*0 

!B  rin §    up  banK  0 

LD 

HL  ,(TRAADR) 

iSet  the  transfer 
i  add  ress 

SET 

7»C 

Sand  denote  a 
5 1  ransfe  r 

LD 

A»(a5AMK 

iSet  BBANK  SVC  (102) 

RST 

2BH 

RETADR 

JR 

NZ, ERROR 

Control  is  returned  to  "RETADR"  under  either  of  two  conditions.  If  there  was  an 
error  in  executing  the  bank  transfer  (for  example,  if  an  invalid  bank  number  was 
specified  or  the  stack  pointer  is  in  high  memory),  the  returned  condition  is  NZ. 
if  the  transfer  took  place  and  PROGB  transferred  back,  the  returned  condition 
is  Z.  Thus,  the  Z  flag  shows  whether  or  not  there  was  a  problem  with  the 
transfer. 

If  PROGB  needs  to  provide  a  return  code,  it  must  be  done  by  using  register  pair 
DE,  IX,  or  IY,  as  registers  AF,  BC,  and  HL  are  used  to  perform  the  transfer,  (Or, 
some  other  technique  can  be  used,  such  as  altering  the  return  transfer  address 
to  a  known  error  trapping  routine) 

PROGB  should  contain  code  that  is  similar  to  that  shown  earlier  For  example 
PROGB  could  be: 


PUSH 

BC 

iSaue  old  banK  data 

PUSH 

HL 

iSaue  the  RET 

iadd  ress 

v  a  u  r 

PROGB  ro 

u tines 

POP 

HL 

HRecoMe  r  transfer 
i  a  d  d  r  e  s  s 

pop 

BC 

iGet  banK  t  ransfe  r 
5  dat  a 

LD 

A, 102 

iSet  SBANK  SVC 

RST 

28H 

JR 

NZ  tERROR 

iError  trap 

PROGB  saves  the  bank  data  (register  BC),  Don't  forget  that  a  transfer  was 
effected  and  register  C  has  bit  7  already  set  when  PROGB  is  entered.  PROGB 
also  saves  the  address  it  needs  to  transfer  back  (which  is  in  HL)  it  then  per- 
forms  whatever  routines  it  has  been  coded  for,  recovers  the  transfer  data,  and 
issues  the  bank  transfer  request.  As  explained  earlier,  an  NZ  return  condition 
from  the  @BANK  SVC  indicates  that  the  bank  transfer  was  not  performed.  You 
should  verify  that  your  application  has  not  violated  the  integrity  of  the  stack 
where  the  transfer  data  was  stored. 

Never  place  disk  drivers,  device  drivers,  device  filters,  or  interrupt  service  rou- 
tines in  banks  other  than  bank  0,  ft  is  possible  to  segment  one  of  the  above 
modules  and  place  segments  in  bank  1  or  2,  provided  the  segment  containing 
the  primary  entry  is  placed  in  bank  0,  You  can  transfer  between  segments  by 
using  the  bank  transfer  techniques  discussed  above. 
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Device  Driver  and  Filter  Templates 


Device  independence  has  its  roots  in  "byte  I/O"  Byte  I/O  is  any  I/O  passed 
through  a  device  channel  one  byte  at  a  time. 

Three  primitive  routines  are  available  at  the  assembly  language  level  for  byte 
I/O  These  byte  I/O  primitives  can  be  used  to  build  larger  routines.  The  three 
primitives  are  the  TRSDOS  supervisor  calls  @GET,  @PUT,  and  @CTL.  @GET 
is  used  to  input  a  byte  from  a  device  or  file,  @PUT  is  used  to  output  a  byte  to  a 
device  or  file,  @CTL  is  used  to  communicate  with  the  driver  routine  servicing 
the  device  or  file 

Other  supervisor  calls  perform  byte  I/O,  such  as  @KBD  (scan  the  keyboard  and 
return  the  key  code  if  a  key  is  down),  @DSP  (display  a  character  on  the  video 
screen),  and  @PRT  (output  a  character  to  the  line  printer).  These  functions 
operate  by  first  loading  register  pair  DE  with  a  pointer  to  a  specific  Device  Con- 
trol Block  (DCB)  assigned  for  use  by  the  device,  then  issuing  a  @GET  or 
@PUT  SVC  for  input  or  output  requests. 

When  TRSDOS  passes  control  over  to  the  device  driver  routine,  the  Z-80  flag 
conditions  are  unique  for  each  different  primitive  This  enables  the  driver  to 
establish  which  primitive  was  used  to  access  the  routine,  so  it  can  turn  over  the 
I/O  request  to  the  proper  driver  or  filter  subroutine  according  io  ihe  type  os 
request — input,  output,  or  control 

The  following  table  shows  the  FLAG  register  conditions  upon  entry  to  a  driver 
or  filter: 

C,NZ  =@GET  primitive 
Z,NC  =  @PUT  primitive 
NZ,NC  =  @CTL  primitive 

Register  B  contains  the  I/O  direction  code:  1  =@GET,  2  =  @PUT,  4  =  @CTL 
Register  C  contains  the  character  code  that  was  passed  in  the  @ PUT  or  @CTL 
supervisor  call.  Register  IX  points  to  the  TYPE  byte  (DCB  +  0)  of  the  Device 
Control  Block  Registers  BC,  DE,  HL,  and  IX  have  been  saved  on  the  stack  and 
are  available  for  use.  Register  AF  is  not  saved;  if  you  want  it  preserved,  your 
program  must  do  so, 

Your  driver  must  start  with  a  standard  front-end  header  (see  "Memory 
Header"): 

BEGIN 


MODDCB 


At  the  start  of  the  actual  module  code,  test  the  condition  of  the  F  register  flags 
for  @GET,  @PUT,  and  @CTL: 

START 

start 
SGo  if  @GET  request 
iGo  if  @PUT  request 
,  ?Nas  OCTL  request 

At  the  label  START,  a  test  is  made  on  the  carry  flag.  If  the  carry  was  set,  then 
the  disk  primitive  must  have  been  an  input  request  (@GET),  An  input  request 
could  be  directed  to  a  part  of  the  driver  which  only  handles  input  from  the 
device 
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JR 

START 

iGo  to  actual  code 
ibedinnind 

DEFW 

M0DEND-1 

iLast  bvte  used  by 
i  m  o  d  u  1  e 

DEFB 

7 

iLenflth  of  name 

DEFM 

'MODNAME' 

iName 

DEFW 

$-$ 

>DC8  Ft  r .  for  this 
i  w  o  d  u  1  e 

DEFW 

0 

iReserued  by  TRSDOS 

EQU 

$ 

Actual 

module  code 

JR 

CiNASGET 

JR 

ZjWASPUT 

If  the  request  was  not  from  the  @GET  primitive,  the  carry  will  not  be  set  The 
next  test  checks  to  see  if  the  zero  flag  is  set.  The  zero  condition  is  preset  when 
a  @PUT  primitive  was  the  initial  request ..  The  jump  to  WASPUT  can  go  to  a  part 
of  the  driver  that  deals  specifically  with  output  to  the  device., 

If  neither  the  zero  nor  carry  flags  are  set,  the  routine  fails  through  to  the  next 
instruction  (not  shown),  which  would  begin  the  part  of  the  driver  that  handles 
@CTL  calls.  For  example,  you  may  want  to  have  an  RS-232C  driver  handle  a 
BREAK  by  issuing  a  @CTL  call  so  that  the  RS-232C  driver  emits  a  true  modem 
break,  but  a  CONTROL  C  would  @PUT  a  X'03! 

Some  drivers  are  written  to  assume  that  @CTL  requests  are  to  be  handled 
exactly  like  @PUT  requests.  This  is  entirely  up  to  the  author  and  the  function  of 
the  driver 

Note  that  when  a  device  is  routed  to  a  disk  file,  TRSDOS  ignores  @CTL 
requests.  That  is,  the  @CTL  codes  are  not  written  to  the  disk  file. 

On  @GET  requests,  the  character  input  should  be  placed  in  the  accumulator 
On  output  requests  (either  @PUT  or  @CTL),  the  character  is  obtained  from 
register  C.  It  is  important  for  drivers  and  filters  to  observe  return  codes.  Specif- 
ically, if  the  request  is  @GET  and  no  byte  is  available,  the  driver  returns  an  NZ 
condition  and  the  accumulator  contains  a  zero  (that  is,  OR  1  :  LD  A,0  :  RET),  If 
a  byte  is  available,  the  byte  is  placed  in  the  accumulator  and  the  Z  flag  is  set 
(that  is,  LD  A.CHAR  :  CP  A  :  RET),  If  there  is  an  input  error,  the  error  code  is 
returned  in  the  accumulator  and  the  Z  flag  is  reset  {that  is,  LD  A.ERRNUM  :  OR 
A  :  RET).  On  output  requests,  the  accumulator  will  contain  the  byte  output  with 
the  Z  flag  set  if  no  error  occurred.  In  the  case  of  an  output  error,  the  accumulator 
must  be  loaded  with  the  error  code  and  the  Z  flag  reset  as  shown  above. 

A  filter  module  is  inserted  between  the  DCB  and  driver  routine  (or  between  the 
DCB  and  the  current  filter  when  it  is  applied  to  a  DCB  already  filtered),  The 
insertion  is  performed  by  the  TRSDOS  FILTER  command  once  the  filter  mod- 
ule is  resident  and  attached  to  a  phantom  DCB,  The  usual  linkage  for  a  filter  is 
to  access  the  chained  module  by  calling  the  @CHNIO  supervisor  call  with  spe- 
cific linkage  data  in  registers  IX  and  BC.  Register  IX  is  loaded  with  the  filter's 
DCB  pointer  obtained  from  the  memory  header  MODDCB  pointer.  Register  B 
must  contain  the  I/O  direction  code  (1  =@GET,  2  =  @PUT,  4  =  @CTL).  This 
code  is  already  in  register  B  when  the  filter  is  entered.  You  can  either  keep  reg- 
ister B  undisturbed  or  load  it  with  the  proper  direction  code.  Also,  output 
requests  expect  the  output  byte  to  be  in  register  C. 

The  DCB  pointer  obtained  from  MODDCB  is  passed  in  register  DE  by  the  SET 
command  and  is  loaded  into  MODDCB  by  your  filter  initialization  routine  The 
initialization  routine  needs  to  relocate  the  filter  to  high  memory  and  attach  itself 
to  the  DCB  assigned  by  the  SET  command,  if  the  initialization  front  end  had 
transferred  the  DCB  pointer  from  DE  to  IX,  then  the  following  code  could  be 
used  to  establish  the  TYPE  byte  and  vector  for  the  filter: 


LD 

(IX)  t47H 

ilnit  DCB  type  to 

LD 

(IX+1) >E 

iFILTER*  G/P/C  I/O 

LD 

(IX+2)  »D 

!&:  stuff  vector 

A  filter  module  can  operate  on  input,  output,  control,  or  any  combination  based 
on  the  author's  design,  The  memory  header  provides  a  region  for  user  data 
storage  conveniently  indexed  by  the  module. 

An  illustration  of  a  filter  follows.  The  purpose  of  this  filter  is  to  add  a  linefeed  on 
output  whenever  a  carriage  return  is  to  be  sent.  Although  the  filter  requires  no 
data  storage,  the  technique  for  accessing  data  storage  is  shown, 
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BEGIN 

JR 

START 

!B ranch    to    start 

DEFH 

FLTEND-i 

?  L  a  s  t    byte    used 

DEFB 

n 

iNawe    length 

DEFM 

'SAMPLE' 

!Name 

MODDCB 

DEFW 

0 

iLinK    to    DCB 

DEFW 

0 

iReserved 

; 

Data 

sto ratfe    area 

for    your    filter 

CR 

EQU 

0DH 

LF 

EQU 

(3AH 

DATA$ 

EQU 

$ 

DATA1 

EQU 

$-DATA$ 

DEFB 

0 

iData    sto  raSe 

DATA2 

EQU 

$-DATA$ 

START 


FLTPUT 


iData  storage 


DEFB    0 

Start  of  filter 

JR      Z  .GOTPUT      iGo  if  §PUT 

@GET  and  8CTL  requests  are  chained  to 

the  next  module  attached  to  the  device. 

This  is  accomplished  b v    f  a  1 1 i  n  9  through 

to  the  dCHNIO  call.  Note  that  the  sample 

filter  does  not  affect  the  B  register* 

so  the  filter  does  not  have  to  load  it 

with  the  direction  code. 

i  S  a  u  e  your  data 


PUSH 


IX 


i  p  o  i  n  t  e  r 

LD 

IXi(MODDCB) 

RX01 

EQU 

$-2 

iGrab    the    DCB    vector 

LD 

A  ,@CHNI0 

5  and    chain    to    it 

RST 

28H 

POP 

IX 

RET 

? 

Filter 

code 

GOTPUT 

LD 

IX»PFDATA$ 

iBase     re*i  ste r    i  s 

RX0Z 

EQU 

$-2 

i u s e d    to    index    data 

LD 

A  >C 

?Get    characte  r    to 
i  test 

CP 

CR 

5If    not    CR  *    put    it 

JR 

NZ>FLTPUT 

CALL 

FLTPUT 

ielse    put    it 

RX03 

EQU 

$-2 

RET 

NZ 

5BacK    on    error 

LD 

C  *LF 

»Add    linefeed 

JR 

FLTPUT 

FLTEND 

EQU 

$ 

; 

Relocation    table 

RELTAB 

DEFW 

RX01  »RX02»R) 

(03 

TABLEN 

EQU 

$-RELTAB/2 

The  relocation  table,  RELTAB,  would  be  used  by  the  filter  initialization  reiocatior 

routine. 

@CTL  Interfacing  to  Device  Drivers 


This  section  discusses  the  @CTL  functions  supported  by  the  system  device 
drivers.  To  invoke  a  @CTL  function,  point  register  pair  DE  to  the  Device  Control 
Block  (DCB),  load  the  function  code  into  register  C,  and  issue  the  @CTL  super- 
visor call.  You  can  locate  the  DCB  address  by  either  1 )  using  the  @GTDCB 
SVC,  or  2)  using  the  @OPEN  SVC  to  open  a  File  Control  Block  containing  the 
device  specification  and  using  the  FCB  address,  See  the  @CTL  supervisor  call 
for  a  list  of  the  function  codes  and  their  meanings. 


Software  42 


The  @CTL  functions  are  listed  below  for  each  driver 

Keyboard  Driver  (resident  driver  assigned  to  *KI) 

A  function  value  of  X'03'  clears  the  type-ahead  buffer  This  serves  the  same 
purpose  as  repeated  calls  to  @KBD  until  no  character  is  available. 

A  function  value  of  X'FF'  is  reserved  for  system  use. 

All  other  function  values  are  treated  as  @GET  requests, 

The  module  name  assigned  to  this  driver  is  "$KI" 

Video  Driver  (resident  driver  assigned  to  *D0) 

All  @CTL  requests  are  treated  as  if  they  were  @PUT  requests 

The  module  name  assigned  to  this  driver  is  "$D0" 

Printer  Driver  (resident  driver  assigned  to  *PR) 

The  printer  driver  is  transparent  to  all  code  values  when  requested  by  the 
@PUT  SVQ  That  means  that  ail  values  from  XW  through  X'FF'  (0-255)  can 
be  sent  to  the  printer  If  the  FORMS  filter  is  attached  to  the  *PR  device,  then 
various  codes  are  trapped  and  used  by  the  filter  according  to  parameters  spec- 
ified with  the  FORMS  library  command,  as  follows: 

X'OD'  —Generates  a  carriage  return  and  optionally  a  linefeed  (ADDLF). 

Generates  form  feeds  as  required., 
X'OA'  —  Treated  the  same  way  as  X'OD' 
X'0C  — Generates  form  feeds  (via  repeated  line  feeds  if  soft  form  feed). 

(FFHARD  =  OFF) 
X'09'  —  Advances  to  next  tab  column, 
X'06'  —  Sets  top-of-form  by  resetting  the  internal  line  counter  to  zero , 

Other  character  codes  may  be  altered  if  the  user  translation  option  of  the 
FORMS  command  (XLATE)  is  set. 

The  printer  driver  accepts  a  function  value  of  X'00*  via  the  @CTL  request  to 
return  the  printer  status,  If  the  printer  is  available,  the  Z  flag  will  be  set  and  reg- 
ister A  will  contain  X'30:  If  the  Z  flag  is  reset,  register  A  will  contain  the  four  high- 
order  bits  of  the  parallel  printer  port  (bits  4-7)., 

The  module  name  assigned  to  the  printer  driver  is  "$PR"The  module  name  of 
the  FORMS  filter  is  M$FF': 

COM  Driver  (non-resident  driver  for  the  RS-232C) 

This  driver  handles  the  interfacing  between  the  RS-232C  hardware  and  byte 
I/O  (usually  the  *CL  device), 

A  @CTL  function  value  of  X'00'  returns  an  image  of  the  RS-232  status  register 
in  the  accumulator.  The  Z  flag  will  be  set  if  the  RS-232  is  available  for  "sending" 
(that  is,  if  the  transmit  holding  register  is  empty  and  the  flag  conditions  match 
as  specified  by  SETCOM), 

A  function  value  of  X'01'  transmits  a  "modem  break"  until  the  next  character  is 
@PUT  to  the  driver, 

A  function  value  of  X'02'  re-initializes  the  UART  to  the  values  last  established 
bySETCOM, 

A  function  value  of  X'04'  enables  or  disables  the  WAKEUP  feature., 

All  other  function  values  are  ignored  and  the  driver  returns  with  register  A  con- 
taining a  zero  value  and  the  Z  flag  set., 

The  WAKEUP  feature  is  useful  for  application  software  specializing  in  com- 
munications. The  RS-232  hardware  can  generate  a  machine  interrupt  under 
any  of  three  conditions:  when  the  transmit  holding  register  is  empty,  when  a 
received  character  is  available,  or  when  an  error  condition  has  been  detected 
(framing  error,  parity  error,  and  so  on),  The  COM  driver  makes  use  of  the 
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"received  character  available"  interrupt  to  take  control  when  a  fully  formed  char- 
acter is  in  the  holding  register.  The  COM  driver  services  the  interrupt  by  reading 
the  character  and  storing  it  in  a  one-character  buffer  COM  then  normally 
returns  from  the  interrupt 

An  application  can  request  that,  instead  of  returning,  control  be  passed  to  the 
application  for  immediate  attention  Note  that  this  action  would  occur  during 
interrupt  handling,  and  any  processing  by  the  application  must  be  kept  to  a  min- 
imum before  control  is  returned  to  COM  via  a  RET  instruction 

If  you  use  a  @CTL  function  value  of  X'04;  then  register  IY  must  contain  the 
address  of  the  handling  routine  in  your  application .  Upon  return  from  the  @CTL 
request,  register  IY  contains  the  address  of  the  previous  WAKEUP  vector  This 
should  be  restored  when  your  application  is  finished  with  the  WAKEUP  feature. 

When  control  is  passed  to  your  WAKEUP  vector  upon  detection  of  a  "receive 
character  available"  interrupt,  certain  information  is  immediately  available  Reg- 
ister A  contains  an  image  of  the  UART  status  register  The  Z  flag  is  set  if  a  valid 
character  is  actually  available.  The  character,  if  any,  is  in  the  C  register. 

Since  system  overhead  takes  a  small  amount  of  time  in  the  @GET  supervisor 
call,  you  may  need  to  @GET  the  character  via  standard  device  interfacing.  This 
ensures  that  any  filtering  or  linking  in  the  *CL  device  chain  will  be  honored.  If, 
on  the  other  hand,  your  application  is  attempting  to  transfer  data  at  ayery  high 
rate  (96(00  oaua  or  higher),  you  may  need  iu  bypass  the  i&GET  SVC  and  use 
the  character  immediately  available  in  the  C  register  Note  that  this  procedure 
bypasses  the  normal  device  chain  (device  routing  and  linking) 

The  module  name  of  the  COM  driver  is  "$CL' 
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8/Using  the  Supervisor  Calls 


Supervisor  Calls  (SVCs)  are  operating  system  routines  that  are  available  to 
assembly  language  programs.  These  routines  alter  certain  system  functions 
and  conditions,  provide  file  access,  and  perform  various  computations.  They 
also  perform  I/O  to  the  keyboard,  video  display,  and  printer. 

Each  SVC  has  a  number  which  you  specify  to  invoke  it,  These  numbers  range 
from  0  to  1 04,, 


In  addition,  under  Version  6.2,  you  can  write  your  own  operating  system  rou- 
tines using  the  numbers  124  through  127  to  install  your  own  SVCs  See  Ap- 
pendix E,  "Programmable  SVCs"  for  more  information 


Calling  Procedure 


TocallaTRSDOSSVC: 

1 .  Load  the  SVC  number  for  the  desired  SVC  into  register  A,,  Also  load  any 
other  registers  which  are  needed  by  the  SVC,  as  detailed  under  Supervisor 
Calls, 

2,  Execute  a  RST  28H  instruction .. 

Note:  If  the  SVC  number  supplied  in  register  A  is  invalid,  the  system  prints  the 
message  "System  Error  xx"  where  xx  is  usually  2B,  It  then  returns  you  to 
TRSDOS  Ready  {not  to  the  program  that  made  the  invalid  SVC  call). 

The  alternate  register  set  (AF,'  BC;  DE;  HL)  is  not  used  by  the  operating  system. 


Program  Entry  and  Return  Conditions 


When  a  program  executed  from  the  @CMNDI  SVC  is  entered,  the  system 
return  address  is  placed  on  the  top  of  the  stack.  Register  HL  will  point  to  the  first 
non-blank  character  following  the  command  name.  Register  BC  will  point  to  the 
first  byte  of  the  command  line  buffer. 

Three  methods  of  return  from  a  program  back  to  the  system  are  available:  the 
@ABORT  SVC,  the  @EXIT  SVC,  and  the  RET  instruction.  For  application  pro- 
grams and  utilities,  the  normal  return  method  is  the  @EXIT  SVC,  If  no  error  con- 
dition is  to  be  passed  back,  the  HL  register  pair  must  contain  a  zero  value.  Any 
non-zero  value  in  HL  causes  an  active  JCL  to  abort. 

The  @ABORT  SVC  can  be  used  as  an  error  return  back  to  the  system;  it  auto- 
matically aborts  any  active  JCL  processing.  This  is  done  by  loading  the  value 
X'FFFF'  into  the  HL  register  pair  and  internally  executing  an  @EXIT  SVC, 

If  stack  integrity  is  maintained,  a  RET  instruction  can  be  used  since  the  system 
return  address  is  put  on  the  stack  by  @CMNDl,  This  allows  a  return  if  the  pro- 
gram was  called  with  @CMNDR. 

Most  of  the  SVCs  in  TRSDOS  Version  6  set  the  Z  flag  when  the  operation  spec- 
ified was  successful.  When  an  operation  fails  or  encounters  an  error,  the  Z  flag 
is  reset  (also  known  as  NZ  flag  set)  and  a  TRSDOS  error  code  is  placed  in  the 
A  register.  The  remaining  SVCs  use  the  Z/NZ  flag  in  differing  ways,  so  you 
should  refer  to  the  description  of  the  SVCs  you  are  using  to  determine  the  exit 
conditions. 
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Supervisor  Calls 


The  TRSDOS  Supervisor  Calls  are: 

Keyboard  SVCs 

Byte  I/O  SVCs 

©CKBRKC 

@CTL 

©KBD 

@GET 

©KEY 

@PUT 

©KEYIN 

File  Control  SVCs 

Printer  and  Video  SVCs 

©CLOSE 

@CLS 

©FEXT 

©DSP 

©FNAME 

@DSPLY 

©FSPEC 

@LOGER 

@INIT 

@LOGOT 

©REMOV 

©MSG 

©OPEN 

(wPBJ 

©RENAM 

©PRINT 
©VDCTL 

Disk  File  Handler  SVCs 

Disk  SVCs 

©BKSP 

©CKEOF 

@DCiNIT 

©LOC 

@DCRES 

©LOF 

©DCSTAT 

©PEOF 

@RDSEC 

©POSN 

©RDSSC 

©READ 

@RSLCT 

©REW 

@RSTOR 

©RREAD 

@SEEK 

©RWRIT 

@SLCT 

©SEEKSC 

@STEPI 

©SKIP 

@VRSEC 

©VER 

@WRSEC 

©WEOF 

@WRSSC 

©WRITE 

@WRTRK 

TRSDOS  Task  Control  SVCs 

System  Control  SVCs 

©ADTSK 
©CKTSK 

@ABORT 

©KLTSK 

@BREAK 

©RMTSK 

@CMNDI 

©RPTSK 

©CMNDR 

©EXIT 

©FLAGS 

@HIGH$ 

@iPL 

@LOAD 

©RUN 

Special  Purpose  Disk  SVCs 

Special  Overlay  SVCs 

@DiRRD 

©CKDRV 

@D!RWR 

©DEBUG 

@GTDCT 

©DODIR 

©HDFMT 

©ERROR 

@RDHDR 

©PARAM 

@RDTRK 

©RAMDIR 
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Miscellaneous  SVCs  Special  Purpose  SVCs 


@BANK 

@CHNIO 

@DATE 

@GTDCB 

(gJDECHEX 

@GTMOD 

<5>DIV8 

@DIV16 

@HEXDEC 

@HEX8 

@HEX16 

@MUL8 

@MUL16 

@PAUSE 

©SOUND 

@TIME 

©WHERE 

See  the  pages  that  follow  for  a  detailed  description  of  each  supervisor  call 
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@ABORT SVC  Number  21 

Abort  Program 

Loads  HL  with  an  X'FFFF'  error  code  and  exits  through  the  @EXIT  supervisor 
call,  Any  active  JCL  processing  is  aborted. 

Entry  Conditions: 

A-21  (X'15') 
General: 

This  SVC  does  not  return. 
Example: 

See  the  example  for  @EXIT  in  Sample  Program  B,  lines  206-207 
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SVC  Number  29 


Add  an  Interrupt  Level  Task 


Adds  an  interrupt  level  task  to  the  real  time  clock  task  table  The  task  slot  num- 
ber can  be  0-11;  however,  some  slots  are  already  assigned  to  certain  functions 
in  TRSDOS.  Slot  assignments  0-7  are  low  priority  tasks  executing  every  266, 67 
milliseconds.  Slots  8-10  are  medium  priority  tasks  executing  every  33.33  milli- 
seconds- Slot  11  is  a  high  priority  task,  executing  every  16,66  milliseconds  High 
Speed  or  33  33  miiliseconds  Low  Speed.  The  system  uses  task  slots  3,  7,  9, 
and  10  for  the  ALIVE,  TRACE,  SPOOL,  and  TYPE-AHEAD  functions, 
respectively 

It  is  a  good  practice  to  remove  an  existing  task  (using  the  @RMTSK  or 
@KLTSK  SVC)  before  installing  a  new  task  in  the  same  task  slot,, 

Entry  Conditions: 

A    =29(X'1D') 

DE = pointer  to  Task  Control  Block  (TCB) 

C    =  task  slot  assignment  (0-1 1 ) 

Exit  Conditions: 

Success  always, 

HL  and  AF  are  altered  by  this  SVC 

The  Task  Control  Block,  or  TCB,  is  a  2-byte  block  of  RAM  which  contains  the 
address  of  the  task  driver  entry  point,  If  your  task  is  prefixed  with  the  memory 
header  described  earlier  under  "Device  Access,"  then  the  TCB  can  be  stored  in 
the  memory  header  data  storage  area.  If  the  task  is  not  a  driver  or  filter,  the  TCB 
can  be  stored  in  the  memory  header  location  MODDCB.  Upon  entry  to  your 
task  routine,  the  IX  register  contains  the  TCB  address 

Example: 

See  Sample  Program  F,  lines  109-120., 
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@BANK SVC  Number  102 

Memory  Bank  Use 

Controls  32K  memory  bank  operation.  The  top  half  of  the  main  64K  block  is 
bank  0,  and  the  alternate  64K  block  is  divided  into  banks  1  and  2.  The  system 
maintains  two  locations  to  perform  bank  management.  These  areas  are  known 
as  "bank  available  RAM"  (BAR)  and  "bank  in  use  RAM"  (BUR). 

If  the  Stack  Pointer  is  not  X7FFE'  or  lower,  the  SVC  aborts  with  an  Error  43  only 
if  B  =  0 

Entry  Conditions: 

A-    102<X'66') 

B      selects  one  of  the  following  functions: 

If  B  =  0,  the  specified  bank  is  selected  and  is  made  addressable. 
The  32K  bank  starts  at  X'8000'  and  ends  at  X'FFFR 
C   =  bank  number  to  be  selected  (0-2) 

If  bit  7  is  set,  then  execution  will  resume  in  the  newly  loaded 
bank  at  the  address  specified. 
HL  =  address  to  start  execution  in  the  new  bank 
!f  B  ~~  1  reset  BUR  and  show  the  bank  not  In  use. 

C  =  bank  number  to  be  selected  (0-2) 
If  B  =  2,  test  BUR  if  bank  is  in  use. 

C  =  bank  number  to  be  selected  (0-2) 
If  B  -  3,  set  BUR  to  show  bank  in  use. 

C^bank  number  to  be  selected  (0-2) 
if  B  =  4,  return  number  of  bank  currently  selected, 

Exit  Conditions: 

!fB-0: 

Success,  Z  flag  set. 
C   =  the  bank  number  that  was  replaced.  If  bit  7  was  set  in  register 

C  on  entry,  it  is  also  set  on  exit. 
HL  =  SVC  return  address.  By  keeping  the  contents  of  C  and  HL, 
you  can  later  return  to  the  instruction  following  the  first 
@BANK  SVC.  See  "Interfacing  RAM  Banks  1  and  2"  for  more 
information. 
Failure,  NZ  flag  set.  Bank  not  present  or  parameter  error 
A   =  error  number 

if  B  =  1: 

Success,  Z  flag  set  Bank  available  for  use 
Failure,  NZ  flag  set,  Bank  not  present, 

lfB-2: 

Success  always, 
If  Z  flag  is  set,  then  the  bank  is  available  for  use.. 
If  NZ  flag  is  set,  then  test  register  A: 

If  A  =/=  X'2B,'  then  the  bank  is  either  in  use  or  it  does  not  exist  on 
your  machine.  Banks  1  and  2  produce  this  error  on  a  64K 
machine 
If  A  =  X'28,'  then  an  entry  parameter  is  out  of  range 

lfB  =  3: 

Success,  Z  flag  set,  Bank  is  now  reserved  for  your  use, 
Failure,  HZ  flag  set,  Test  register  A: 
If  A  ^  X'2B;  then  the  bank  is  already  in  use  or  does  not  exist  Banks 

1  and  2  produce  this  error  on  a  64K  machine. 
If  A  =  X'2B;  then  an  entry  parameter  is  out  of  range. 
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lfB-4: 

Success  always. 
A  -  number  of  the  bank  which  is  currently  resident 

General: 

AF  is  altered  for  all  functions. 

BC  is  altered  if  the  SVC  is  successful. 

Example: 

See  the  section  "Interfacing  RAM  Banks  1  and  2" 
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BKSP  SVC  Number  61 


Backspace  One  Logical  Record 


Performs  a  backspace  of  one  logical  record, 

Entry  Conditions: 

A    =61  (X'3D*) 

DE= pointer  to  FCB  of  the  file  to  backspace 

Exit  Conditions: 

If  the  Z  flag  is  set  or  if  A  =  X'1  C  or  X'1  D,'  then  the  operation  was  successful 
The  LOC  pointer  to  the  file  was  backspaced  one  record  Otherwise, 
A  =  error  number 

If  A  =  X'1  C  is  returned,  the  file  pointer  is  positioned  at  the  end  of  the  file. 
Any  Appending  operations  would  be  performed  here. 
If  A  =  X'1  D'  is  returned,  the  file  pointer  is  positioned  beyond  the  end  of 
the  file 

General: 

Only  AF  is  altered  by  this  SVO 

If  the  LOC  pointer  was  at  record  0  when  the  call  was  executed,  the  results 
are  indeterminate. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311 
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BREAK  SVC  Number  103 


Set  Break  Vector 


Sets  a  user  or  system  break  vector.  The  BREAK  vector  is  an  abort  mechanism; 
there  is  no  return. 

The  BREAK  vector  executes  whenever  the  following  conditions  occur  at  the 
same  time:  1 )  the  Program  Counter  is  greater  than  X'2400,'  2)  the  BREAK  key 
is  pressed,  and  3)  a  real  time  clock  interrupt  which  executes  30  times  per  sec- 
ond occurs. 

After  executing  this  SVC,  you  must  reset  bit  4  of  SFLAG$.  The  BREAK  flag  in 
KFLAG$  (bit  0)  requires  the  setting  of  SFLAG$  bit  4  and  a  delay  of  01  to  0,5 
second  to  clear  any  other  interrupts  that  may  be  pending.  Then  you  can  enter 
your  BREAK  key  handier  (in  which  the  BREAK  key  bit  in  SFLAG$  is  reset).,  See 
KFLAG$  and  SFLAG$  in  the  section  about  the  ©FLAGS  SVC  for  more 
information. 

Entry  Conditions: 

A   -103(X'67') 

HL  =  user  break  vector 

HL  -  0  (sets  system  break  vector) 

Exit  Conditions: 

Success  always. 

HL^  existing  break  vector  {if  user  break  vector  was  set) 

Note:  @EXIT  and  @CMND!  automatically  restore  BREAK  to  the  system  han- 
dler, @CMNDR  does  not  do  this. 
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@CHN10 SVC  Number  20 

Pass  Control  to  Next  Module  in  Device  Chain 

Passes  control  to  the  next  module  in  the  device  chain. 

Entry  Conditions: 

A  =  20(X'14') 

IX  =  contents  of  DCB  in  the  header  block 
B  ^GETIPUTICTL  direction  code  (1/2/4) 
C  =  character  (if  output  request) 

General: 

IX  is  not  checked  for  validity,, 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates" 
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CKBRKC SVC  Number  106 

Check  BREAK  bit  and  clear  it  Version  6.2  only 

Checks  to  see  if  the  BREAK  key  has  been  pressed  If  a  BREAK  condition  exists, 
(aCKBRKC  resets  the  break  bit,  Bit  0  of  KFLAG$ 

Entry  Conditions: 

A-106(X'6A') 

Exit  Conditions: 

Success  always. 

If  Z  flag  is  set,  the  break  bit  was  not  detected.,  If  NZ  flag  is  set,  the 
break  bit  was  detected  and  is  cleared.  If  the  BREAK  key  is  being  de~ 
pressed,  the  SVC  wili  not  return  until  the  key  is  released. 

General: 

Only  AF  is  altered  by  this  SVC 
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CKDRV  SVC  Number  33 


Check  Drive 


Checks  a  drive  reference  to  ensure  that  the  drive  is  in  the  system  and  a 
TRSDOS  Version  6  or  LDOS  5.13  (Model  Hi  Hard  Disk  Operating  System)  for- 
matted disk  is  in  place 

Entry  Conditions: 

A  =  33(X'2f) 

0= logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

If  2  flag  is  set,  the  drive  is  ready 

If  CF  is  set,  the  disk  is  write  protected., 
If  NZ  flag  is  set,  the  drive  is  not  ready.,  The  user  may  examine  DCT  +  0 
to  see  if  the  drive  is  disabled. 

Example: 

See  Sample  Program  D,  lines  35-55., 
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CKEOF SVC  Number  62 

Check  for  End-Of-File 

Checks  for  the  end  of  file  at  the  current  logical  record  number 

Entry  Conditions: 

A    =62(X'3E) 

DE = pointer  to  the  FCB  of  the  file  to  check 

Exit  Conditions: 

Success  always,, 

If  Z  fiag  is  set,  LOG  does  not  point  at  the  end  of  file  {LOC  <  LOF}„ 
If  NZ  flag  is  set,  test  A  for  error  number: 

If  A  =  X'1  C  LOC  points  at  the  end  of  the  file  (LOC  -  LOF) . 

If  A  =  X'1  D;  LOC  points  beyond  the  end  of  the  file  (LOC  >  LOF),. 

If  A  =/=  X'  1 C  or  X'1  d;  then  A  =  error  number. 

General: 

Only  AF  is  altered  by  this  SVC 

Example: 

o~.-  r> ~t-  n,-.~^., o    t;,~-^.  oco  orro 

occs  ooinpic  i    luyieuii  w,  mi  ic;o  ou£.ojo 
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J\TbJ\ SVC  Number  28 

Check  if  Task  Slot  in  Use 

Checks  to  see  if  the  specified  task  slot  is  in  use 

Entry  Conditions: 

A-28(X'1C) 

C  -  task  slot  to  check  (0-1 1 ) 

Exit  Conditions: 

Success  always. 

If  Z  flag  is  set,  the  task  slot  is  available  for  use. 
If  NZ  flag  is  set,  the  task  slot  is  already  in  use. 

General: 

AF  and  HL  are  altered  by  this  SVC 

Example: 

See  Sample  Program  F;  lines  70-73, 
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@CLOSE SVC  Number  60 

Close  a  File  or  Device 

Terminates  output  to  a  file  or  device.  Any  unsaved  data  in  the  buffer  area  is 
saved  to  disk  and  the  directory  is  updated,  All  files  that  have  been  written  to 
must  be  closed,  as  well  as  all  files  opened  with  UPDATE  or  higher  access. 

If  you  remove  a  diskette  containing  an  open  file,  any  attempt  to  close  the  file 
results  in  the  message: 

**  CLOSE  FAULT  **  error  message,  <ENTER>  to  retry,  <BREAK>  to 
abort 

where  error  message  is  usually  "Drive  not  ready"  You  may  put  the  diskette 
back  In  the  drive  and: 


1  Press  (ENTER)  to  close  the  file 

2  Press  (BREAK)  to  abort  the  close, 

if  you  press  (BREAK),  the  NZ  flag  is  set  and  Register  A  contains  X'20\  the  error 
code  for  an  Illegal  drive  number  error 

Entry  Conditions: 

A    =60{X'3C) 

DE= pointer  to  FOB  or  DCB  to  close 

Exit  Conditions: 

Success,  Z  flag  set.  The  file  or  device  was  closed.  The  filespec  (excluding 

the  password)  or  the  devspec  is  returned  to  the  FCB  or  DCB. 
Failure,  NZ  flag  set, 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  C(  lines  360-368 
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@CLS SVC  Number  105 

Clear  Video  Screen  Version  6,2  only 

Clears  the  video  screen  by  sending  a  Home  Cursor  (X'1  C)  and  Clear  to  End  of 
Frame  (X'1  F')  sequence  to  the  video  driver. 

Entry  Conditions: 

A  =  105(X'69') 

Exit  Conditions: 

Success,  Z  flag  is  set- 
Failure,  NZ  is  set. 

A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC 
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CRUMPS SVC  Number  24 

Execute  Command  with  Return  to  System 

Passes  a  command  string  to  TRSDOS  for  execution.  After  execution  is  com- 
plete, control  returns  to  TRSDOS  Ready,  If  the  command  gets  an  error,  it  still 
returns  to  TRSDOS  Ready. 

Entry  Conditions: 

A    -24(X'18t) 

HL^pointer  to  buffer  containing  command  string  terminated  with  X'&D' 
(up  to  80  bytes,  including  the  XW) 

General: 

This  SVC  does  not  return. 

Example: 

See  Sample  Program  E,  lines  43-58. 
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CMNDR  SVC  Number  25 


Execute  Command 


Executes  a  command  or  program  and  returns  to  the  calling  program.  The  exe- 
cuted program  should  maintain  the  Stack  Pointer  and  exit  via  a  RET  instruction. 
All  TRSDOS  library  commands  comply  with  this  requirement. 

If  bit  4  of  CFLAG$  is  set  (see  the  (&FLAGS  SVC),  then  (&CMNDR  executes 
only  system  library  commands. 

Entry  Conditions: 

A   =25(X'19') 

HL = pointer  to  buffer  containing  command  string  terminated  with  X'QD' 
(up  to  80  bytes,  including  the  X'OD') 

Exit  Conditions: 

Success  always, 

HL  =  return  code  (See  the  section  "Converting  to  TRSDOS  Version  6" 

for  information  on  return  codes.) 
Registers  AF,  BC,  DE,  IX,  and  IY  are  altered  by  the  command  or  pro- 

or?.m  executed  b^this  SVC. 
If  the  command  invokes  a  user  program  which  uses  the  alternate  reg- 
isters, they  are  modified  also,. 

Example: 

See  Sample  Program  E,  lines  18-29, 
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SVC  Number  5 


Output  a  Control  Byte 


Outputs  a  control  byte  to  a  logical  device.  The  DCB  TYPE  byte  (DCB  +  0,  Bit  2) 
must  permit  CTL  operation.  See  the  section  "@CTL  Interfacing  to  Device  Driv- 
ers" for  information  on  which  of  the  functions  listed  below  are  supported  by  the 
system  device  drivers. 

Entry  Conditions: 

A    =5(X'05') 

DE = pointer  to  DCB  to  control  output 

C  selects  one  of  the  following  functions: 

If  C  =  0,  the  status  of  the  specified  device  wilt  be  returned. 

If  C  =  1,  the  driver  is  requested  to  send  a  BREAK  or  force  an  interrupt. 

If  C  =  2,  the  initialization  code  of  the  driver  is  to  be  executed. 

If  0  =  3,  all  buffers  in  the  driver  are  to  be  reset  This  causes  all  pending 

I/O  to  be  cleared. 
If  C  -  4,  the  wakeup  vector  for  an  interrupt-d  riven  driver  is  specified  by 
the  caller 

IY  =  address  to  vector  when  leaving  driver.  If  IY  =  0,  then 

the  wakeup  vector  function  is  disabled.  The  RS-232C 

driver  COM/DVR  ($CL),  is  the  only  system  driver  that 

provides  wakeup  vectoring 

If  G  =  8,  the  next  character  to  be  read  will  be  returned.  This  allows  data 

to  be  "previewed"  before  the  actual  @GET  returns  the  character, 

Exit  Conditions: 

lfC-0, 

Z  flag  set,  device  is  ready 
NZ  flag  set,  device  is  busy 

A  =  status  image,  if  applicable 
Note:  This  is  a  hardware  dependent  image, 
lfC  =  1, 

Success,  Z  flag  set,  BREAK  or  interrupt  generated. 
Failure,  NZ  flag  set 
A- error  number 
ifC  =  2, 

Success,  Z  flag  set  Driver  initialized. 
Failure,  NZ  flag  set 
A  =  error  number 
lfC-3, 

Success,  Z  flag  set.  Buffers  cleared. 
Failure,  NZ  flag  set, 
A  =  error  number 
lfC-4, 

Success  always. 

IY  ~  previous  vector  address 
This  function  is  ignored  if  the  driver  does  not  support  wakeup 
vectoring, 
lfC  =  8, 

Success,  Z  flag  set,  Next  character  returned, 

A = next  character  in  buffer 
Failure,  NZ  flag  set.  Test  register  A: 
If  A  =  0,  no  pending  character  is  in  buffer 
If  A^0,  A  contains  error  number  (TRSDOS  driver  returns  Error  43.) 
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General: 

BC,  DE,  HL,  and  IX  are  saved. 

Function  codes  5  to  7,  9  to  31,  and  255  are  reserved  for  the  system.  Function  codes 

32  to  254  are  available  for  user  definition. 
Entry  and  exit  conditions  for  user-defined  functions  are  up  to  the  design  of  the  user- 

supplied  driver 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates" 
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DATE  SVC  Number  18 


Get  Date 


Returns  today's  date  in  display  format  (MM/DD/YY), 

Entry  Conditions: 

A    =  18(X'12') 

HL  =z pointer  to  8-byte  buffer  to  receive  date  string 

Exit  Conditions: 

Success  always, 

HL = pointer  to  the  end  of  the  buffer  supplied  +  1 
DE= pointer  to  start  of  DATES  storage  area  in  TRSDOS 
BC  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  F,  lines  252-253., 
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@DCIN1T SVC  Number  42 

Initialize  the  FDC 

Issues  a  disk  controller  initialization  command.  The  floppy  disk  driver  treats  this 
the  same  as  @RSTOR  (SVC  44). 

Entry  Conditions: 

A  =  42(X'2A) 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

Example: 

See  the  example  for  @CKDRV  in  Sample  Program  D,  lines  38-39 
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CRES  SVC  Number  43 


Reset  the  FDC 


Issues  a  disk  controller  reset  command.  The  floppy  disk  driver  treats  this  the 
same  as  @RSTOR  (SVC  44), 

Entry  Conditions: 

A-43(X'2B') 

C^  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set, 
A  =  error  number 

Example: 

See  the  example  for  @CKDRV  in  Sample  Program  D,  lines  38-39, 
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@DCSTAT SVC  Number  40 

Test  if  Drive  Assigned  in  OCT 

Tests  to  determine  whether  a  drive  is  defined  in  the  Drive  Code  Table  (DCT). 

Entry  Conditions: 

A-  40(X'28') 

C  -  logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

If  Z  is  set,  the  specified  drive  is  already  defined  in  the  OCT 
If  NZ  is  set,  the  specified  drive  is  not  defined  in  the  DCT 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  D,  lines  27-33 
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DEBUG  SVC  Number  27 


Enter  DEBUG 


Forces  the  system  to  enter  the  DEBUG  utility.  Pressing  ©  dHUE)  from  the 
DEBUG  monitor  causes  program  execution  to  continue  with  the  next  instruc- 
tion. If  you  want  to  use  the  functions  in  the  extended  debugger  when  DEBUG 
is  entered  in  this  fashion,  you  must  issue  the  DEBUG  (E)  command  {optionally 
with  the  @CMNDR  SVC)  before  this  SVC  is  executed, 

Entry  Conditions: 

A  =  27(X'1B') 

General: 

This  SVC  does  not  return  unless  ©  is  entered  in  DEBUG. 

Example: 

See  Sample  Program  A,  lines  54-60., 
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@DECHEX SVC  Number  96 

Convert  Decimal  ASCII  to  Binary 

Converts  a  decimal  ASCII  string  to  a  16-bit  binary  number.  Overflow  is  not 
trapped,  Conversion  stops  on  the  first  out-of-range  character, 

Entry  Conditions: 

A   =  96(X'60'} 

H  L = pointer  to  decimal  string 

Exit  Conditions: 

Success  always, 

BC  =  binary  conversion  of  ASCII  string 
HL  =  pointer  to  the  terminating  byte 
AF  is  altered  by  this  SVQ 

Example: 

See  Sample  Program  B,  tines  88-95, 
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D1RRD SVC  Number  87 

Directory  Record  Read 

Reads  a  directory  sector  that  contains  the  directory  entry  for  a  specified  Direc- 
tory Entry  Code  (DEC)  The  sector  is  placed  in  the  system  buffer  and  the  reg- 
ister pair  HL  points  to  the  first  byte  of  the  directory  entry  specified  by  the  DEC 

Entry  Conditions: 

A  =  87(X*57') 

B  =  Directory  Entry  Code  of  the  file 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set, 

HL = pointer  to  directory  entry  specified  by  register  B 
Failure,  NZ  flag  set, 

A   =  error  number 

HL  is  altered. 

General: 

AF  is  always  altered. 

If  the  drive  does  not  contain  a  disk,  this  SVC  may  hang  indefinitely  waiting 
for  formatted  media  to  be  placed  in  the  drive.  The  programmer  should 
perform  a  @CKDRV  SVC  before  executing  this  call 

If  the  Directory  Entry  Code  is  invalid,  the  SVC  may  not  return  or  it  may 
return  with  the  Z  flag  set  and  HL  pointing  to  a  random  address,  Care 
should  be  taken  to  avoid  using  the  wrong  value  for  the  DEC  in  this  call 

Example: 

See  Sample  Program  C,  lines  152-174 
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@D1RWR SVC  Number  88 

Directory  Record  Write 

Writes  the  system  buffer  back  to  the  disk  directory  sector  that  contains  the 
directory  entry  of  the  specified  DEC, 

Entry  Conditions: 

A  =  88(X'58') 

B  =  Directory  Entry  Code  of  the  file 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set, 

HL  ^pointer  to  directory  entry  specified  by  register  B 
Failure,  NZ  flag  set, 

A   =  error  number 

HL  is  altered. 

General: 

AF  is  always  altered. 

If  the  drive  does  not  contain  a  disk,  this  SVC  may  hang  indefinitely  waiting 
for  formatted  media  to  be  placed  tn  the  drive.  The  programmer  should 
perform  a  @CKDRV  SVC  before  executing  this  call,. 

If  the  Directory  Entry  Code  is  invalid,  the  SVC  may  not  return  or  it  may 
return  with  the  Z  flag  set  and  HL  pointing  to  a  random  address,  Care 
should  be  taken  to  avoid  using  the  wrong  value  for  the  DEC  in  this  call, 

Example: 

See  the  example  for  @DIRRD  in  Sample  Program  C,  lines  152-174. 
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DIV8  SVC  Number  93 


8-Bit  Divide 


Performs  an  8-bit  unsigned  integer  divide. 

Entry  Conditions: 

A  =  93(X*5D*) 
E  =  dividend 
C  =  divisor 

Exit  Conditions: 

Success  always, 
A  =  quotient 
E  =  remainder 
No  other  registers  are  altered. 

Example: 

See  Sample  Program  B,  lines  61-64, 
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@DIV16  SVC  Number  94 

16-Bit  by  8-Bit  Divide 


Performs  a  division  of  a  16-bit  unsigned  integer  by  an  8-bit  unsigned  integer 

Entry  Conditions: 

A  =  94(X'5E') 
HL^  dividend 
C  =  divisor 

Exit  Conditions: 

Success  always 
HL  =  quotient 
A   =  remainder 
No  other  registers  are  altered,. 

Example: 

See  Sample  Program  B,  lines  105-109 
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POPIR SVC  Number  34 

Do  Directory  Display /Buffer 

Reads  files  from  a  disk  directory  or  finds  the  free  space  on  a  disk.  The  directory 
information  is  either  displayed  on  the  screen  (in  five-across  format)  or  sent  to  a 
buffer,  The  directory  information  buffer  consists  of  18  bytes  per  active,  visible 
file:  the  first  16  bytes  of  the  directory  record,  plus  the  ERN  (ending  record  num- 
ber). An  X'FF  marks  the  buffer  end, 

Entry  Conditions: 

A  =  34(X'22') 

C= logical  drive  number  (0-7) 
B  selects  one  of  the  following  functions: 
If  B^0,  the  directory  of  the  visible,  non-system  files  on  the  disk  in  the 
specified  drive  is  displayed  on  the  screen  The  filenames  are  dis- 
played in  columns,  5  filenames  per  line, 
If  B- 1,  the  directory  is  written  to  memory., 

HL^ pointer  to  buffer  to  receive  information 
If  B  =  2,  a  directory  of  the  files  on  the  specified  drive  is  displayed  for  files 
that  are  visible,  non-system,  and  match  the  extension  partspec 
pointed  to  by  HL 
HL  -partspec  for  the  filename's  extension 

This  field  must  contain  a  valid  3-character  extension,  padded 
with  dollar  signs  ($).,  For  example,  to  display  all  visible,  non- 
system  files  that  have  the  letter  'C*  as  the  first  character  of  the 
extension,  HL  should  point  to  the  string  "C$$" 
If  B  =  3,  a  directory  of  the  files  on  the  specified  drive  is  written  to  the  buffer 
that  is  specified  by  HL  for  files  that  match  the  extension  partspec 
pointed  to  by  HL„ 
HL = pointer  to  the  3-byte  partspec  and  to  the  buffer  to  receive  the 

directory  records  (see  general  notes) 
Keep  in  mind  that  the  area  pointed  to  by  HL  is  shared.,  If  you  are 
using  this  buffer  more  than  once,  you  have  to  re-create  the 
partspec  in  the  buffer  before  each  call  because  the  previous 
call  will  have  erased  the  partspec  by  writing  the  directory 
records. 
If  B  =  4,  the  disk  name,  original  free  space,  and  current  free  space  on  the 
disk  is  read, 
HL= pointer  to  a  20-byte  buffer  to  receive  information 

Exit  Conditions: 

Success,  Z  flag  set,. 

If  B  - 1  or  3,  the  directory  records  have  been  stored, 

HL- pointer  to  the  beginning  of  the  buffer 
If  B  -  0  or  2,  the  filenames  or  matching  filenames  are  displayed  with  5 

filenames  per  line 
If  B  =  4,  the  disk  name  and  free  space  information  are  stored  in  the 
format: 
Bytes   0-7  =  Disk  name,  Disk  name  is  padded  on  the  right 

with  blanks  (X'20*), 

Bytes   8-15  =  Creation  date  (the  date  the  disk  was  formatted 

or  was  the  target  disk  in  a  mirror  image 

backup),,  The  date  is  in  the  format  MM/DD/YY, 

Bytes  16-1 7~  Total  K  originally  available  in  binary  LSB-MSB 

format. 
Bytes  18-1 9  =  Free  K  available  now  in  binary  LSB-MSB 
format 
HL= pointer  to  the  beginning  of  the  data  area 
Failure,  NZ  flag  set 
A  =  error  number 
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General: 

AF  is  the  only  register  aitered  by  this  SVC 

t  he  size  of  the  buffer  to  receive  directory  records  must  be  large  enough  to 
hold  directory  entries  for  the  maximum  number  of  files  allowed  on  the 
drive  and  disk  you  specify  For  example,  if  the  drive  is  a  hard  disk,  you 
must  be  able  to  store  256  directory  entries,  and  each  entry  requires  18 
bytes  of  storage.  For  more  information  on  calculating  the  amount  of 
space  needed  for  this  buffer,  see  the  tables  under  "Directory  Records:' 
They  give  the  maximum  number  of  entries  allowed  on  a  given  type  of 
disk.  You  must  add  2  records  to  this  value  when  B  =  1  to  store  the  direc- 
tory entry  for  DIR/SYS  and  BOOT/SYS. 

Example: 

See  Sample  Program  E,  lines  32-40. 
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DSP  SVC  Number  2 


Display  Character 


Outputs  a  byte  to  the  video  display.  The  byte  is  displayed  at  the  current  cursor 
position. 

Entry  Conditions: 

A  =  2(X'02') 

C  =  byte  to  display 

Exit  Conditions: 

Success,  Z  flag  set, 

A  =  byte  displayed 
Failure,  NZ  flag  set, 

A  ~  error  number 

General: 

DE  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  C,  lines  219-221 
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@DSPLY SVC  Number  10 

Display  f\/tess8g©  Lin© 

Displays  a  message  Sine,  starting  at  the  current  cursor  position.  The  line  must 
be  terminated  with  either  a  carriage  return  {X'OD')  or  an  ETX  (X'03'),  If  an  ETX 
terminates  the  line,  the  cursor  is  positioned  immediately  after  the  last  character 
displayed, 

Entry  Conditions: 

A    -10(X'0A) 

HL  -pointer  to  first  byte  of  message 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  and  DE  are  altered  by  this  SVC. 

Example: 

See  Sample  Proaram  0:  lines  35-37 
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SVC  Number  26 


Entry  to  Post  an  Error  Message 


Provides  an  entry  to  post  an  error  message.,  If  bit  7  of  register  C  is  set,  the  error 
message  is  displayed  and  return  is  made  to  the  calling  program  If  bit  6  is  not 
set,  the  extended  error  message  is  displayed  Under  versions  prior  to  6  2  the 
error  display  is  in  the  following  format: 

***    Errcod=xx*    Error    message    string    #*# 

<filespec  or  d  e  v  s  p  e  c  > 
Referenced  at  X  '  d  d  d  d  ' 

Under  Version  6,2  the  error  display  is  in  the  following  format: 

*#Error  code  =  x  x  t   Returns  to  X  '  d ddd   ' 

#  #  E  r  r  a  r  message  string 

•ifilespect  dev spec  t  or  open  FCB /DCB  status > 

Last  SUC  =  nnm  Returned  to  X'  r  r  r  r  ' 

dddd  is  the  return  address  of  the  («  ERROR  SVC  in  the  application  program 

nnn  Is  the  last  SVC  executed  before  the  &  ERROR  SVC  request 

rrrr  is  the  address  the  previous  SVC  returned  to  in  the  application  program 

If  bit  6  is  set,  then  only  the  "Error  message  string"  is  displayed.  This  bit  is 
ignored  if  bit  6  of  SFLAG$  (the  extended  error  message  bit)  is  set.  If  bit  6  of 
CFLAG$  is  set,  then  no  error  message  is  displayed.,  If  bit  7  of  CFLAG$  is  set, 
then  the  "Error  message  string"  is  placed  in  a  user  buffer  pointed  to  by  register 
pair  DE.  See  {«)FLAGS  (SVC  101)  for  more  information  on  SFLAG$  and 
CFLAG$, 

Entry  Conditions: 

A  =  26(X,1A) 

C  -  error  number  with  bits  6  and  7  optionally  set 

Exit  Conditions: 

Success  always 

General: 

To  avoid  a  looping  condition  that  could  result  from  the  display  device  gen- 
erating an  error,  do  not  check  for  errors  after  returning  from  @ ERROR, 

If  you  do  not  set  bit  6  of  register  C,  then  you  should  execute  this  SVC  only 
after  an  error  has  actually  occurred. 

Example: 

See  Sample  Program  C,  lines  379-389 
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@EXIT  SVC  Number  22 


Exit  to  TRSDOS 


This  is  the  normal  program  exit  and  return  to  TRSDOS,.  An  error  exit  can  be 
done  by  placing  a  non-zero  value  in  HL  Values  1  to  62  indicate  a  primary  error 
as  described  in  TRSDOS  Error  Codes  (Appendix  A)„  (A  non-zero  value  in  HL 
causes  an  active  JCL  to  abort.) 

Entry  Conditions: 

A   =22(X'16') 
HL=  Return  Code 

If  HL  =  0,  then  no  error  on  exit 

If  HL  ±  0,  then  the  @ABORT  SVC  returns  X'FFFF'  in  HL  automatically. 

General: 

This  SVC  does  not  return, 

Example: 

See  Sample  Program  B,  lines  206-207 
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FEXT SVC  Number  79 

Set  Up  Default  File  Extension 

Inserts  a  default  file  extension  into  the  File  Control  Block  if  the  file  specification 
entered  contains  no  extension..  @FEXT  must  be  done  before  the  file  is  opened. 

Entry  Conditions: 

A    =79(X'4F) 
DE= pointer  to  FCB 

HL=pointer  to  default  extension  (3  characters;  alphabetic  characters 
must  be  upper  case  and  first  character  must  be  a  letter) 

Exit  Conditions: 

Success  always. 

AF  and  BC  are  altered  by  this  SVC, 

If  the  default  extension  is  used,  HL  is  also  altered., 

Example: 

See  Sample  Program  C,  lines  111-132. 
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©FLAGS         SVC  Number  101 

Point  IY  to  System  Flag  Table 

Points  the  I Y  register  to  the  base  of  the  system  flag  table.  The  status  flags  listed 
below  can  be  referenced  off  IY.  You  can  after  those  bits  marked  with  an  asterisk 
(*),  Bits  without  an  asterisk  are  indicators  of  current  conditions,  or  are  unused 
or  reserved, 

Note:  You  may  wish  to  save  KFLAG$  and  SFLAG$  if  you  intend  to  modify  them 
in  your  program,  and  restore  them  on  exit. 

Entry  Conditions: 

A=101  (X'65*) 

Exit  Conditions: 

Success  always, 

IY = pointer  to  the  following  system  information: 

IY  - 1       Contains  the  overlay  request  number  of  the  last  system  module 
resident  in  the  system  overlay  region 

IY  +  0  =  AFLAG$  (allocation  flag  under  Version  6  2  only) 

Contains  the  starting  cylinder  number  to  be  used  when 
searching  for  free  space  on  a  diskette,  it  is  normally  1 
If  the  starting  cylinder  number  is  larger  than  the  number 
of  cylinders  for  a  particular  drive,  1  is  used  for  that  drive 

IY  +  2   =  CFLAG$ 

*  bit  7      —  If  set,  then  (a  ERROR  will  transfer  the  "Error  message 

string"  to  your  buffer  instead  of  displaying  it.  The  mes- 
sage is  terminated  with  X'OD/ 

*  bit  6      —  If  set,  do  not  display  system  error  messages  0-62  See 

(a  ERROR  (SVC  26)  for  more  information 

*  bit  5      —  If  set,  sysgen  is  not  allowed 

*  bit  4      —  If  set,  then  @CMNDR  will  execute  only  system  library 

commands, 
bit  3      —  If  set,  @RUN  is  requested  from  either  the  SET  or 

SYSTEM  (DRIVER  =  )  commands, 
bit  2      —  If  set,  @KEYIN  is  executing  due  to  a  request  from 

SYS1 
bit  1       —  If  set,  @CMNDR  is  executing.  This  bit  is  reset  by 

@EXITand@CMNDI. 

*  bit  0      —  If  set,  HIGH$  cannot  be  changed  using  @HIGH$ 

(SVC  100).  This  bit  is  reset  by  @EXIT  and  @CMNDI. 
IY  +  3   =DFLAG$    (device  flag) 

*  bit  7      —  "1"  if  GRAPHIC  printer  capability  desired  on  screen 

print  ((control)  CD  causes  screen  print.  See  the  SYS- 
TEM (GRAPHIC)  command  under  "Technical  infor- 
mation on  TRSDOS  Commands  and  Utilities") 

bit  6      —  "1"  if  KSM  module  is  resident 

bit  5      —  Currently  unused 

bjt  4      —  i,f  jf  MemDisk  active 

bit  3      —  Reserved 

bit  2      —  "1"  if  Disk  Verify  is  enabled 

*  bit  1       —  "1"  if  TYPE-AHEAD  is  active 
bit  0      ~~~  "1"  if  SPOOL  is  active 

IY  +  4   -  EFLAG$  (ECI  flag  under  Version  6  2  only) 

Indicates  the  presence  of  an  ECI  program  If  any  of  the 
bits  are  set,  an  ECI  is  used,  rather  than  the  SYS1  inter- 
preter. The  ECI  program  may  use  these  bits  as  necce- 
sary  However,  at  least  one  bit  must  be  set  or  the  ECI  is 
not  executed 
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IY  +  5   -FEMSK$   (mask  for  port  0FEH) 
IY  +  8   =  IFLAG$      (international  flag) 

*  bit  7      —  If  "1,"  7-bit  printer  filter  is  active 

If  "0,"  normal  8-bit  filters  are  present 

*  bit  6      —  If  "1"  international  character  translation  will  be  per- 

formed  by  printer  driver 

If  "0"  characters  received  by  printer  driver  will  be  sent 

to  the  printer  unchanged 
bit  5      —  Reserved  for  future  languages 
bit  4      —  Reserved  for  future  languages 
bit  3      —  Reserved  for  future  languages 
bit  2      —  Reserved  for  future  languages 
bit  1       —  If  "1"  German  version  of  TRSDOS  is  present 
bit  0      —  If  *x  French  version  of  TRSDOS  is  present 
If  bits  5-0  are  all  zero,  then  USA  version  of  TRSDOS  is  present, 
I Y  + 1 0  -  KFLAG$    (keyboard  flag) 

bit  7      —  "1"  if  a  character  is  present  in  the  type-ahead  buffer 
bit  6      —  Currently  unused 

*  bit  5      —  "1"  if  CAPS  lock  is  set 
bit  4      —  Currently  unused 

bit  3      —  Currently  unused 

*  bit  2      —  "1"  if  (ENTER)  has  been  pressed 

*  bit  1       ~~  "1"  if  (SHIFT)  (D  has  been  pressed  (PAUSE) 

*  bit  0      —  "1"  if  (breaR)  has  been  pressed 

Note:  To  use  bits  0-2,  you  must  first  reset  them  and  then  test  to 

see  if  they  become  set, 
I Y  + 1 2  =  MODOUT  (image  of  port  OECH) 
IY  +  13  =  NFLAG$  (network  flag  under  Version  6,2) 

bit  7      —  Reserved  for  system  use. 

bit  6  —  If  set,  the  application  program  is  in  the  task  processor, 
Programmers  must  not  modify  this  bit. 

bit  5      —  Reserved  for  system  use 

bit  4      —  Reserved  for  system  use 

bit  3      —  Reserved  for  system  use, 

bit  2      —  Reserved  for  system  use 

bit  1       —  Reserved  for  system  use 

*  bit  0      —  If  set,  the  "file  open  bit"  is  written  to  the  directory, 
IY  + 1 4  =  OPREG$  (memory  management  &  video  control  image) 

IY  + 1 7  =  RFLAG$  (retry  flag  under  Version  6,2  only) 

Indicates  the  number  of  retrys  for  the  floppy  disk  driver,, 
This  should  be  an  even  number  larger  than  two 
IY+18-SFLAG$    (system  flag) 

bit  7      —  "1"  if  DEBUG  is  to  be  turned  on 

*  bit  6      —  "1"  if  extended  error  messages  desired  (see 

@ERROR  for  message  format);  overrides  the  setting 
of  bit  6  of  register  C  on  ©ERROR  (SVC  26)  and 
should  be  used  only  when  testing 
bit  5      —  "1"  if  DO  commands  are  being  executed 

*  bit  4      — 'T  if  BREAK  disabled 

bit  3  —  "1"  if  the  hardware  is  running  at  4  mhz  (SYSTEM 
(FAST)),  If  "O,"  the  hardware  is  running  at  2  mhz  (SYS- 
TEM (SLOW)), 

*  bit  2      —  "1"  if  LOAD  called  from  RUN 

*  bit  1       —  "1"  if  running  an  EXECute  only  file 

*  bit  0      —  "1"  specifies  no  check  for  matching  LRL  on  file  open 

and  do  not  set  file  open  bit  in  directory.  This  bit  should 
be  set  just  before  executing  an  @OPEN  (SVC  59)  if 
you  want  to  force  the  opened  file  to  be  READ  only  dur- 
ing current  I/O  operations.  As  soon  as  either  call  is 
executed,  SFLAG$  bit  0  is  reset.,  If  you  want  to  disable 
LRL  checking  on  another  file,  you  must  set  SFLAG$ 
bit  0  again, 
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IY  + 1 9  =  TFLAG$  (type  flag  under  Version  6 2  only) 

Identifies  the  Radio  Shack  hardware  model  TFLAG$ 
allows  programs  to  be  aware  of  the  hardware  environ- 
ment and  the  character  sets  available  for  the  display 
Current  assignments  are: 

2  indicates  Model  II 

4  indicates  Model  4 

5  indicates  Model  4P 
12  indicates  Model  12 

IY  +  20  =  UFLAG$  (user  flag  under  Version  6  2  only) 

May  be  set  by  application  programs  and  is  sysgened 

properly 
IY  +  21  =  VFLAG$ 

bit  7      —  Reserved  for  system  use 

*  bit  6      —  "1"  selects  solid  cursor,  "0"  selects  blinking  cursor 
bit  5      —  Reserved  for  system  use 

*  bit  4      —  "1"  if  real  time  clock  is  displayed  on  the  screen 
bits  0-3  —  Reserved  for  system  use 

IY  +  22  =  WR!NTMASK$    (mask  for  WRINTMASK  port) 

IY  +  26  =  SVCTABPTR$     (pointer  to  the  high  order  byte  of  the  SVC  table 

address;  low  order  byte  =  00) 
IY  +  27  =  Version  ID  byte    (60H  =  TRSDOS  version  6  0.x„x, 

61  H  =  TRSDOS  version  6 1  x,x,  etc.) 
IY- 47  =  Operating  system  release  number  Provides  a  third  and  fourth 

character  (12H  =  TRSDOS  version  xxt .2) 
IY  +  28 
to 

IY  +  30  =  @ICNFG  vector 
IY  +  31 
to 
IY  + 33  =  @KITSK  vector 
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FNAME  SVC  Number  80 


Get  Filename 


Gets  the  filename  and  extension  from  the  directory  using  the  specified  Direc- 
tory Entry  Code  (DEC)  for  the  file, 

Entry  Conditions: 

A    -80(X'50') 

DE^  pointer  to  16-byte  buffer  to  receive  fiiename/extension:dhver  fol- 
lowed by  a  X'OD'  as  a  terminator 
B    -  DEC  of  desired  file 
C    -  logical  drive  number  of  drive  containing  file  (0-7) 

Exit  Conditions: 

Success,  2  flag  set 

HL^  pointer  to  directory  entry  specified  by  register  B 
Failure,  NZ  flag  set, 

A   -  error  number 

HL  is  altered. 

General: 

AF  and  BC  are  always  altered, 

if  the  drive  does  not  contain  a  disk,  this  SVC  may  hang  indefinitely  waiting 

for  formatted  media  to  be  placed  in  the  drive,  The  programmer  should 

perform  a  @CKDRV  SVC  before  executing  this  call 
If  the  Directory  Entry  Code  is  invalid,  the  SVC  may  not  return  or  it  may 

return  with  the  Z  flag  set  and  HL  pointing  to  a  random  address.  Care 

should  be  taken  to  avoid  using  the  wrong  value  for  the  DEC  in  this  call 

Example: 

See  Sample  Program  C,  lines  274-286, 
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FSPEC SVC  Number  78 

Assign  File  or  Device  Specification 

Moves  a  file  or  device  specification  from  an  input  buffer  into  a  File  Control  Block 
(FCB).  Conversion  of  lower  case  to  upper  case  is  made  automatically. 

Entry  Conditions: 

A    -78(X'4E') 

HL = pointer  to  buffer  containing  filespec  or  devspec 

DE= pointer  to  32-byte  FCB  or  DCB 

Exit  Conditions: 

Success  always, 

If  the  Z  flag  is  set,  the  file  specification  is  valid. 

HL = pointer  to  terminating  character 

DE= pointer  to  start  of  FCB 
If  the  NZ  flag  is  set,  a  syntax  error  was  found  in  the  filespec, 

HL = pointer  to  invalid  character 

DE^  pointer  to  start  of  FCB 

A   =  invalid  character 

General: 

AF  and  BC  are  altered. 

Example: 

See  Sample  Program  C,  lines  53-65. 
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@GET SVC  Number  3 

Get  One  Byte  From  Device  or  File 


Gets  a  byte  from  a  logical  device  or  a  file.  The  DCB  TYPE  byte  (DCB  +  0,  Bit  C 
must  permit  a  GET  operation  for  this  call  to  be  successful 

Entry  Conditions: 

A    -3(X'03') 

DE  = pointer  to  DCB  or  FCB 

Exit  Conditions: 

Success,  Z  flag  set. 

A  =  character  read  from  the  device  or  file 
Failure,  NZ  flag  set.  Test  register  A: 

If  A  =  0,  no  character  was  available, 

If  A  4  0,  A  contains  error  number. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates!' 
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@GTDCB SVC  Number  82 

Get  Device  Control  Block  Address 

Finds  the  location  of  a  Device  Control  Block  (DCB),  if  DE  =  0  {no  device  name 
specified),  HL  returns  the  address  of  the  first  unused  DCB  found., 

Entry  Conditions: 

A    -82{X'52') 

DE  =  2-character  device  name  {B  -  first  character,  D  =  second  character) 

Exit  Conditions: 

Success,  Z  flag  set,  DCB  was  found- 

HL = pointer  to  start  of  DCB 
Failure,  NZ  flag  set.  No  DCB  was  available- 

A   -  Error  8  (Device  not  available) 

HL  is  altered. 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

Seethe  section  "Device  Driver  and  Filter  Templates" 
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@GTDCT  SVC  Number  81 


Get  Drive  Code  Table  Address 


Gets  the  address  of  the  Drive  Code  Table  for  the  requested  drive. 

Entry  Conditions: 

A  =  81  (X'5f) 

C  =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always, 

I Y = pointer  to  the  DOT  entry  for  the  specified  drive 
AF  is  always  altered  by  this  SVC, 

General: 

If  the  drive  number  is  out  of  range,  the  !Y  pointer  will  be  invalid.  This  call 
does  not  return  2/NZ  to  indicate  if  the  drive  number  specified  is  valid 
(0-7)  or  enabled. 

Example: 

See  the  example  for  @DCSTAT  in  Sample  Program  D,  lines  27-33,. 
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GTMOD SVC  Number  83 

Get  Memory  Module  Address 

Locates  a  memory  module,  if  the  standard  memory  header  is  at  the  start  of  the 
module.,  The  scanning  starts  with  the  system  drivers  in  low  memory,  then 
moves  to  any  high  memory  modules.  If  any  routine  is  encountered  that  does  not 
start  with  a  proper  header,  scanning  stops. 

Entry  Conditions: 

A    =83(X'53') 

DE  -  pointer  to  memory  module  name  in  upper  case,  terminated  with  any 
character  in  the  range  00-31 

Exit  Conditions: 

Success  always. 

If  the  Z  flag  is  set,  the  module  was  found. 

HL = pointer  to  first  byte  of  memory  header 
DB=pointer  to  first  byte  after  module  name 

If  the  NZ  flag  is  set,  the  module  was  not  found, 
HL  is  altered. 

General: 

AF  is  always  altered  by  this  SVC, 

Example: 

See  Sample  Program  F,  lines  144-154, 
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@HDFMT  SVC  Number  52 


Hard  Disk  Format 


Passes  a  format  drive  command  to  a  hard  disk  driver  if  the  hard  disk  controller 
accepts  it  as  a  valid  command,  then  it  formats  the  entire  disk  drive.  If  the  hard 
disk  controller  does  not  accept  it,  then  an  error  is  returned.  Radio  Shack  hard- 
ware does  not  currently  support  @HDFMT. 

Entry  Conditions: 

A  =  52(X'34') 

C-  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set 
A  =  error  number 
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HEXDEC SVC  Number  97 

Convert  Binary  to  Decimal  ASCII 

Converts  a  binary  number  in  HL  to  decimal  ASCII 

Entry  Conditions: 

A    =97(X'6f) 

HL- number  to  convert 

DE= pointer  to  5-character  buffer  to  hold  converted  number 

Exit  Conditions: 

Success  always, 

DE  ^pointer  to  end  of  buffer  +  1 

AF,  BC,  and  HL  are  altered  by  this  SVC 

Example: 

See  Sample  Program  B,  lines  73-76. 
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@HEX8 SVC  Number  98 

Convert  1  Byte  to  Hex  ASCII 

Converts  a  1-byte  number  to  hexadecimal  ASCI!. 

Entry  Conditions: 

A   -98(X'62') 

C  -  number  to  convert 

HL  -  pointer  to  a  2-character  buffer  to  hold  the  converted  number 

Exit  Conditions: 

Success  always. 

HL = pointer  to  the  end  of  buffer  + 1 
Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  236-246. 
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HEX18 SVC  Number  99 

Convert  2  Bytes  to  Hex  ASCII 

Converts  a  2-byte  number  to  hexadecimal  ASCII,, 

Entry  Conditions: 

A    =  99(X'63') 

DE^  number  to  convert 

HL = pointer  to  4-character  buffer  to  hold  converted  number 

Exit  Conditions: 

Success  always. 

H  L = pointer  to  end  of  buffer  + 1 
Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  248-258., 
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@HIGH$ SVC  Number  100 

Get  or  Alter  HIGHS  or  LOW$ 

Provides  the  means  to  read  or  alter  the  HIGH$  and  LOW$  values. 

Note;  HIGH$  must  be  greater  than  LOW$.  LOW$  is  reset  to  X'2FFF  by  (&EXIT, 
©ABORT,  and  @CMNDI. 

Entry  Conditions: 

A  =  100(X'64') 

B  selects  HIGH$  or  LOW$ 

If  B  =  0,  SVC  deals  with  HIGH$ 

If  B  ^  0,  SVC  deals  with  LOW$ 
HL  selects  one  of  the  following  functions: 

If  HL  =  0,  the  current  HIGH$  or  LOW$  is  returned 

If  HL^  0,  then  HIGH$  or  LOW$  is  set  to  the  value  in  HL 

Exit  Conditions: 

Success,  Z  flag  set 

HL  -  current  HIGH$  or  LOW$„  If  HL  ±  0  on  entry,  then  H  IGH$  or  LOW$ 
is  now  set  to  that  value 
Failure,  NZ  flag  set. 

A   -  error  number 

General: 

If  bit  0  of  CFLAG$  is  set  (see  @FLAGS),  then  HIGH$  cannot  be  changed 
with  this  call.  The  call  returns  error  43,  "SVC  parameter  error'' 

Example: 

See  Sample  Program  f-  lines  75-86, 
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INIT 


SVC  Number  58 


Open  or  Initialize  File 


Opens  a  file.  If  the  file  is  not  found,  this  SVC  creates  it  according  to  the  file 
specification, 

Entry  Conditions: 

A    =  58(X'3A) 

HL^pointer  to  256-byte  disk  I/O  buffer 

DE= pointer  to  FCB  containing  the  file  specification 

B   =  Logical  Record  Length  to  be  used  while  file  is  open 

Exit  Conditions: 

Success,  Z  flag  set.  File  was  opened  or  created., 

The  CF  flag  is  set  if  a  new  file  was  created. 
Failure,  NZ  flag  set, 

A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

The  file  open  bit  is  set  in  the  directory  if  the  access  level  is  UPDATE  or 
greater 

Example: 

See  Sample  Program  C,  lines  260-272., 
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@IPL  SVC  Number  0 

Reboot  the  System 

Does  a  software  reset.  Floppy  drive  0  must  contain  a  system  disk,  @IPL  uses 
the  standard  boot  sequence,  the  same  as  for  a  hard  reset  (pressing  the  reset 
button).  Memory  locations  X'41  E5'-X'4225'  and  X'4300'-X'43FF  are  altered 
during  the  boot  of  the  machine. 

Entry  Conditions: 

A  =  0(XW) 

General: 

This  SVC  does  not  return. 
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KBD SVC  Number  8 

Scan  Keyboard  and  Return 

Scans  the  keyboard  and  returns  a  character  if  a  key  is  pressed-  If  no  key  is 
pressed,  a  zero  value  is  returned,, 

Entry  Conditions: 

A-8(XW) 

Exit  Conditions: 

Success,  Z  flag  set 

A  =  character  pressed 
Failure,  NZ  set, 

if  A  -  0,  no  character  was  available. 

If  A  4  0,  then  A  contains  error  number 

General: 

DE  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  C,  lines  198-200. 
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@KEY SVC  Number  1 

Scan  *KI  Device,  Waif  for  Character 

Scans  the  *K!  device  and  returns  with  a  character  it  does  not  return  until  a 
character  is  input  to  the  device, 

Note:  The  system  suspends  execution  of  the  program  that  issued  the  SVC  until 
a  character  can  be  obtained,  Background  tasks  will  continue  to  run  normally. 

Entry  Conditions; 
A  =  1  (X'Of) 

Exit  Conditions: 

Success,  Z  flag  set. 

A  -  character  entered 
Failure,  NZ  flag  set. 

A  =  error  number 

General: 

DE  is  altered  by  this  SVC, 

See  Sample  Program  B,  lines  202-203, 
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@KEYIN SVC  Number  9 

Accept  a  Line  of  Input 

Accepts  a  line  of  input  until  terminated  by  either  an  CeUTer)  or  a  (BREAK).  Entries 
are  displayed  on  the  screen,  starting  at  the  current  cursor  position.  Backspace, 
tab,  and  line  delete  are  supported  If  JCL  is  active,  the  line  is  fetched  from  the 
active  JCL  file. 

Entry  Conditions: 

A    -9(XW) 

HL^pointerto  user  line  buffer  of  length  B  + 1 
B  =  maximum  number  of  characters  to  input 
C   =0 

Exit  Conditions: 

Success,  Z  flag  set 

HL=pointerto  start  of  buffer 

B   -  actual  number  of  characters  input 

CF  is  set  if  (BREAK)  terminated  the  input., 
Failure,  NZflag  set, 

A   =  error  number 

General: 

DE  and  C  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  39-47 
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@KLTSK SVC  Number  32 

Remove  Currently  Executing  Task 

When  called  by  an  executing  task  driver,  removes  the  task  assignment  from  the 
task  table  and  returns  to  the  foreground  application  that  was  interrupted. 

Entry  Conditions: 

A  =  32(X'20') 

General: 

This  SVC  does  not  return. 

Example: 

See  the  example  for  @RMTSK  in  Sample  Program  F,  lines  134-142, 
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@LQAD SVC  Number  76 

Load  Program  File 

Loads  a  program  file.  The  file  must  be  in  load  module  format, 

Entry  Conditions: 

A    =76(X'4C) 

DE = pointer  to  FCB  containing  filespec  of  the  file  to  load 

Exit  Conditions: 

Success,  Z  flag  set, 

HL  =  transfer  address  retrieved  from  file 
Failure,  NZ  flag  set 

A   terror  number 

Example: 

See  Sample  Program  A,  lines  50-56. 
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@LOC  SVC  Number  63 

Calculate  Current  Logical  Record  Number 

Returns  the  current  logical  record  number 

Entry  Conditions: 

A    =63(X'3F) 

DE  =  pointer  to  the  file's  FCB 

Exit  Conditions: 

Success,  Z  flag  set. 

BC = logical  record  number 
Failure,  NZ  flag  set. 

A    =  error  number 

General: 

AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  C,  lines  305-311 
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@LQF SVC  Number  64 

Calculate  the  EOF  Logical  Record  Number 

Returns  the  EOF  (End  of  File)  logical  record  number 

Entry  Conditions: 

A    =64(X'40') 

DE  =  pointer  to  FCB  for  the  file  to  check 

Exit  Conditions: 

Success,  Z  flag  set., 

BC  -  the  EOF  logical  record  number 
Failure,  NZ  flag  set., 

A    =  error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311. 
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@LQGER SVC  Number  11 

issue  Log  Message 

Issues  a  log  message  to  the  Job  Log„  The  message  can  be  any  character  string 
terminating  with  a  carriage  return  (X'OD*). 

Entry  Conditions: 

A    -11  (X'OB*) 

HL = pointer  to  first  character  in  message  line 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set 
A = error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

LD    HL >TEXT    » Point  at  message  to  output 
LD    A»£L0GER   fand  output  it  to  the  Job 

?  I  o  * 
RST   28H       iCall  the  (3L0GER  SYC 

TEXT:  DEFM   'This  is  a  message  for  the  Job  Lo£ ' 
DEFB  0DH       SMessase  must  be  terminated 
iwith  an  <ENTER>* 
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@LQGOT SVC  Number  12 

Display  and  Log  Message 

Displays  and  logs  a  message.,  Performs  the  same  function  as  @DSPLY  fol- 
lowed by  @LOGER. 

Entry  Conditions: 

A   -12(X'0C'} 

HL= pointer  to  first  character  in  message  line 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set, 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

To  avoid  a  looping  condition  that  could  result  from  the  display  device  gen- 
erating an  error,  no  error  checking  should  be  done  after  returning  from 
@LOGOT. 

Example: 

LD    HLiTEKT    SPoint  at  message  to  output 
LD    AtiLOGOT   ?and  output  it  to  the  Job 

il_o3  AND  the  display 
RST   Z8H       iCall  the  @L0G0T  BUG 

TEXT:   DEFM  'This  message  will  be  displayed  both  in' 
DEFM   'the  Job  LoS  and  on  the  display.' 
DEFB  0DH       *Must  terminate  text  with  an 
K ENTER >. 
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@MSG SVC  Number  13 

SsncS  BVSgsssq©  to  D@vsc@ 

Sends  a  message  line  to  any  device  or  file. 

Entry  Conditions: 

A    =13(X'0D') 

DE= pointer  to  DCB  or  FCB  of  device  or  fife  to  receive  output 

HL-pointer  to  message  line  terminated  with  X'0D'  or  X'03' 

Exit  Conditions: 

Success,  Z  flag  set 
Failure,  NZ  flag  set, 
A= error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

LD    HLjTEXT    J  Point  at  message  to  output 
LD    DE>DCBP   iPoint  at  the  device  control 

5  b  1  o  c  K  for  our  device 
LD    A>@MSG     Und  write  this  text  to  it 
RST   28H       iCall  the  @MSG  SMC 

TEXT:   DEFM  'D555-555<LGGIN  USER>'  SText  to  write  to 
!  t  h  i  s  device*  In  this  case* 
iit  is  a  dialing  modem* 
DEFB  03 H       iTerwinate  the  message 
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MULS  SVC  Number  90 


8-Bit  Multiplication 


Performs  an  8-bit  by  8-bit  unsigned  integer  multiplication.  The  resultant  product 
must  fit  into  an  8-bit  field. 

Entry  Conditions: 

A  =  90(X,5A') 
C= multiplicand 
E  =  multiplier 

Exit  Conditions: 

Success  always, 
A= product 
DE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  150-153. 
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@MUL16 SVC  Number  91 

16-Bit  by  8-Bit  Multiplication 

Performs  an  unsigned  integer  multiplication  of  a  16-bit  multiplicand  by  an  8-bit 
multiplier  The  resultant  product  is  stored  in  a  3-byte  register  field. 

Entry  Conditions: 

A    -91  (X'SB') 
HL^  multiplicand 
C   =  multiplier 

Exit  Conditions: 

Success  always,, 

HL  =  two  high-order  bytes  of  product 
A   =  low-order  byte  of  product 
DE  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  B,  lines  183-187 
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OPEN SVC  Number  59 

Open  Existing  File  or  Device 

Opens  an  existing  file  or  device. 

Entry  Conditions: 

A    -59(X'3B') 

HL = pointer  to  256-byte  disk  I/O  buffer 

DE= pointer  to  FCB  or  DCB  oontaining  fifespec  or  devspec 

B   =  logical  record  length  for  open  file 

Exit  Conditions: 

Success,  Z  flag  set, 
Failure,  NZ  flag  set. 
A  terror  number 

General: 

AF  is  altered  by  this  SVC, 

The  file  open  bit  is  set  in  the  directory  if  the  access  level  is  UPDATE  or 
greater. 

Example: 

See  Sample  Program  C,  lines  134-150. 
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@PARAM SVC  Number  17 

Parse  Parameter  String 

Parses  an  optional  parameter  string.  Its  primary  function  is  to  parse  command 
parameters  contained  in  a  command  line  starting  with  a  parenthesis.  The 
acceptable  parameter  format  is: 

PARM  =  X'nnnn'..  .hexadecimal  entry 

PARM  =  nnnnn  .....decimal  entry 

PARM  =  "string" ..  alphanumeric  entry 

PARM  =  flag       ON,  OFF,  Y,  N,  YES,  or  NO 

Note:  Entering  a  parameter  with  no  equal  sign  or  value  is  the  same  as 
using  PARM  -  ON.  Entering  PARM=  with  no  value  is  the  same  as 
using  PARM  ^  OFF 

Entry  Conditions: 

A   =17<X'1T) 

DE= pointer  to  beginning  of  your  parameter  table 
HL=pointer  to  command  line  to  parse  {the  parameter  string  is  enclosed 
within  parentheses) 

Exit  Conditions: 

Success  always. 

If  Z  is  set,  either  valid  parameters  or  no  parameters  were  found. 
If  NZ  is  set,  a  bad  parameter  was  found. 

General: 

NZ  is  not  returned  if  parameter  types  other  than  those  specified  are 
entered..  The  application  must  check  the  validity  of  the  response  byte. 

The  valid  parameters  are  contained  in  a  user  table  which  must  be  in  one  of  the 
following  formats.  (Parameter  names  must  consist  of  alphanumeric  charac- 
ters, the  first  of  which  is  a  letter;) 

For  use  with  TRSDOS  Version  6,  use  this  format: 

The  parameter  table  starts  with  a  single  byte  X'80.'  Each  parameter  is 
stored  in  a  variable  length  field  as  described  below. 

1)  Type  Byte  (Type  and  length  byte) 
Bit  7 — If  set,  accept  numeric  value 
Bit  6 — If  set,  accept  flag  parameter 
Bit  5  —  If  set,  accept  "string"  value 

Bit  4 — If  set,  accept  first  character  of  name  as  abbreviation 
Bits  3-0 — Length  of  parameter  name 

2)  Actual  Parameter  Name 

3)  Response  byte  (Type  and  length  found) 
Bit  7 — Numeric  value  found 

Bit  6 — Flag  parameter  found 

Bit  5  —  String  parameter  found 

Bits  4-0 — Length  of  parameter  entered.  If  length  is  0  and  the  2-byte 
vector  points  to  a  quotation  mark  (X'22')t  then  the  parameter 
was  a  null  string.  Otherwise,  a  length  of  0  indicates  that  the 
parameter  was  longer  than  31  characters. 

4)  2-byte  address  vector  to  receive  the  parsed  parameter  values. 

The  2-byte  memory  area  pointed  to  by  the  address  field  of  your  table 
receives  the  value  of  PARM  if  PARM  is  non-string„  If  a  string  is  entered,  the 
2-byte  memory  area  receives  the  address  of  the  first  byte  of  "string."  The 
entries  ON,  YES,  and  Y  return  a  value  of  X'FFFF';  OFF,  NO,  and  N  return 
X'0000!  if  a  parameter  name  is  specified  on  the  command  line  and  is  fol- 
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lowed  by  an  equal  sign  and  no  value,  then  X'0000'  or  NO  is  returned.  If  a 
parameter  name  is  used  on  the  command  line  without  the  equal  sign,  then 
a  value  of  X'FFFF*  or  ON  is  assumed.  For  any  allowed  parameter  that  is 
completely  omitted  on  the  command  line,  the  2-byte  area  remains 
unchanged  and  the  response  byte  Is  0. 

The  parameter  table  is  terminated  with  a  single  byte  X'00' 

For  compatibility  with  LDOS  5.13,  use  this  format: 

A  6-character  "word"  left  justified  and  padded  with  blanks  followed  by  a  2- 
byte  address  to  receive  the  parsed  values.  Repeat  word  and  address  for  as 
many  parameters  as  are  necessary.  You  must  place  a  byte  of  XW  at  the 
end  of  the  table. 

Example: 


LD 
LD 
LD 

RST 
JR 

LD 

AND 

JR 


LD 
OR 
JR 

JR 


HLtCQMAND 

DEiPARM 

AtGPARAM 

28H 

NZ, ERROR 

A»(RESP> 

040H 

Z»BAD 


A»(UAL) 

A 

Z,0FF 


ON 


SPoint  at  co  rum  a  rid  buffer 

SPoint  at  parameter  list 

SParse  the  items  on  the 

icommand  line 

(Call  the  0PARAM  SUC 

!Ari  error  occurred  (not 

>  included  here) 

(Get  response  code 

(Test  response  flaSs 

(User  specified  something 

JliKe  UPDATE=X'123a'  or 

iUPDATE="HELLO" 

(Get  1st  byte  of  UAL  word 

(Test  the  value 

iUPDATE=0FF  or  UPDATE=N0  was 

(Specified 

;UPDATE=ON    or    UPDATE=YES    was 

ispecified 


COMAND: 

DEFS 

80 

PARM: 

DEFB 

80H 

DEFB 

40H+S 

DEFM 

'UPDATE' 

RESP: 

DEFB 

0 

DEFkl 

UAL 

DEFB 

0 

UAL: 

DEFS 

2 

5 Area    where    command    is 

»sto  red 

iTable  header  code 

1 4  0  says  we  want  a  flatf 

!<YES/N0) .  G  is  length  of 

J  the  parameter  name 

iParamete r  name 

iResPonse  area 

JUecto  r  to  UAL 

!End  of  Table  code 

?Area  to  receiue  a  parameter 

5  v  a  1  u  e 
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©PAUSE SVC  Number  16 

Suspend  Program  Execution 

Suspends  program  execution  for  a  specified  period  of  time  and  goes  into  a 
"holding"  state.  The  delay  is  at  least  14.3  microseconds  per  count. 


Entry  Conditions: 

A    -16(X'10') 

BC  =  delay  count 

Exit  Conditions: 

Success  always. 

Example: 

LD          BC36A2H 

SWait    for    about    200    milli 

Iseconds.    14.3    usees    # 

51398G    is    approx.    200 

i  in  s  e  c  s 

LD          A*§PAUSE 

i  S  u  5  p  e  n  d    e  x  e  c  u  t  i  a  n 

RST        28H 

iCall    the    0PAUSE    SMC 
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EOF SVC  Number  65 

Position  to  End  Of  File 

Positions  an  open  file  to  the  End  Record  Number  (ERN)„  An  end-of-file- 
encountered  error  (X'1C)  is  returned  if  the  operation  is  successful  Your  pro- 
gram may  ignore  this  error 

Entry  Conditions: 

A    =65(X'41') 

DE  ^pointer  to  FOB  of  the  file  to  position 

Exit  Conditions; 

NZ  flag  aiways  set 

if  A  =  X'1  Ct'  then  success. 

If  A  4  X'1C;  then  failure- 

A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311 
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@POSN  SVC  Number  66 


rosition  rue 


Positions  a  file  to  a  logical  record.  This  is  useful  for  positioning  to  records  of  a 
random  access  file. 

When  the  @POSN  routine  is  used,  Bit  6  of  FCB  +  1  is  automatically  set,  This 
ensures  that  the  EOF  (End  Of  File)  is  updated  when  the  file  is  closed  only  if  the 
NRN  (Next  Record  Number)  exceeds  the  current  ERN  (End  Record  Number) 

Note  that  @POSN  must  be  used  for  each  write,  even  if  two  records  are  side  by 
side. 

Entry  Conditions: 

A    =  66(X'42') 

DE  = pointer  to  FOB  for  the  file  to  position 

BC  =  the  logical  record  number 

Exit  Conditions: 

If  Z  flag  is  set  or  A  =  X'1  C  or  X'1  D,'  then  success. 

The  file  was  positioned. 
Otherwise,  failure,. 

A  =  tsf/u/'  tiuiituwt 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311 
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@PRSNT SVC  Number  14 

Prints  Message  Line 


Outputs  a  message  line  to  the  printer  The  line  must  be  terminated  with  either  a 
carriage  return  (X'0D')  or  an  ETX  (X'03')„ 

Entry  Conditions: 

A    =  14{X'0E') 

HL^  pointer  to  message  to  be  output 

Exit  Conditions: 

Success,  Z  flag  set 
Failure,  NZ  flag  set 
A  ~  error  number 

General: 

AF  and  DE  are  altered  by  this  SVC, 

Example: 

LD    HL  >TEXT   SText  to  be  output  to  the 

Sprinter 
LD    A»§PRINT   iWrite  this  message  to  the 

iprinte  r  device 
RST   28H       !Call  the  §PRINT  SVC 

TEXT:   DEFB  0CH       »Do  a  Top  of  Form 

DEFM   'Report  continued  Patfe 

DEFB  3         ^Terminate  with  a  <ETX>  or 
ian  <ENTER> 
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PRT 


SVC  Number  6 


Send  Character  to  Printer 


Outputs  a  byte  to  the  line  printer 

Entry  Conditions: 

A-6(X'06') 

C= character  to  print 

Exit  Conditions: 

Success,  Z  flag  set 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  and  DE  are  altered  by  this  SVC 

If  the  line  printer  is  attached  but  becomes  unavailable  (out  of  paper,  out  of 
ribbon,  turned  off,  off-line,  buffer  full,  etc.),  the  printer  driver  waits  approx- 
imately ten  seconds,  If  the  printer  is  still  not  ready,  a  "Device  not  avail- 
able" error  is  returned. 


iGet  the  pa$e  number 
iMake  it  ASCII 
5 P u t  the  value  here 
iWrite  this  character  to  the 
ip  r in t e  r 
RST   28H       iCall  the  (3PRT  SMC 

PAGE:   DEFB  2         iStart  with  patfe  2 


Example: 

LD 

A* (PAGE) 

ADD 

A*  '0' 

LD 

C*A 

LD 

A>t§PRT 
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UT SVC  Number  4 

Write  One  Byte  to  Device  or  File 

Outputs  a  byte  to  a  logical  device  or  file.  The  DCB  TYPE  byte  (DCB  +  0,  Bit  1) 
must  permit  PUT  operation, 

Entry  Conditions: 

A    =4(X'04') 

DE  ^pointer  to  DCB  or  FCB  of  the  output  device 

C    -  byte  to  output 

Exit  Conditions: 

Success,  Z  f!ag  set. 
Failure,  NZ  flag  set 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC. 

Example: 

See  the  section  "Device  Driver  and  Filter  Templates." 
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@RAMDIR SVC  Number  35 

Get  Directory  Record  or  Free  Space 

Reads  the  directory  information  of  visible  files  from  a  disk  directory,  or  gets  the 
amount  of  free  space  on  a  disk. 

Entry  Conditions: 

A    -35(X'23') 

HL^ pointer  to  RAM  buffer  to  receive  information 

B   =  logical  drive  number  (0-7) 

C      selects  one  of  the  following  functions: 

If  C  =  0,  get  directory  records  of  all  visible  files 

If  C  -  255,  get  free  space  information, 

if  C  =  1-254,  get  a  single  directory  record  (see  below) . 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  HZ  flag  set, 
A= error  number 

Each  directory  record  requires  22  bytes  of  space  in  the  buffer  If  C  =  0,  one  addi- 
tional byte  is  needed  to  mark  the  end  ot  the  butter 

For  single  directory  records,  the  number  in  the  C  register  should  be  one  less 
than  the  desired  directory  record.  For  example,  if  C=1,  directory  record  2  is 
fetched  and  put  in  the  buffer,  If  a  single  record  request  is  for  an  inactive  record 
or  an  invisible  file,  the  A  register  returns  an  error  code  25  (File  access  denied). 

The  directory  information  is  placed  in  the  buffer  as  follows: 

Byte  Contents 

00-1 4  filename/ext:d  (left  justified,  padded  with  spaces) 

1 5  protection  level,  0  to  6 

1 6  EOF  offset  byte 

1 7  logical  record  length,  0  to  255 
18-19  ERNoffile 

20^21      file  size  in  K  (1024-byte  blocks) 

22  LAST  RECORD  ONLY  Contains "  + "  to  mark  buffer  end. 

If  C  =  255,  HL  should  point  to  a  4-byte  buffer  Upon  return,  the  buffer  contains: 

Bytes  00-01     Space  in  use  in  K,  stored  LSB,  MSB 
Bytes  02-03    Space  available  in  K,  stored  LSB,  MSB 

Example: 

See  the  example  for  @DODIR  in  Sample  Program  E,  lines  32-40. 
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@RDHDR        SVC  Number  48 

Read  a  Sector  Header 

Reads  the  next  ID  header  when  supported  by  the  controller  driver  The  floppy 
disk  driver  supplied  treats  this  as  a  @RDSEC  (SVC  49), 

Entry  Conditions: 

A    =  48(X'30'} 

HL  -pointer  to  buffer  to  receive  the  data 

D  =cylindertoread 

C  =  logical  drive  number 

E   =  sector  to  read 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

Example: 

See  the  example  for  @RDSEC  in  Sample  Program  D,  lines  63-66, 
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RDSEC  SVC  Number  49 


Read  Sector 


Transfers  a  sector  of  data  from  the  disk  to  your  buffer, 

Entry  Conditions: 

A    =49(X'3f) 

HL = pointer  to  the  buffer  to  receive  the  sector 

D   -  cylinder  to  read 

E   =  sector  to  read 

C   ^logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set, 
A -error  number 

General: 

Only  AF  is  altered  by  this  SVC 

Example: 

See  Samole  Proa  ram  D.  line?  63-66 
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RDSSC SVC  Number  85 

Read  System  Sector 

Reads  the  specified  system  (directory)  sector  if  the  cylinder  number  in  register 
D  is  not  the  directory  cylinder,  the  value  in  D  is  changed  to  reflect  the  real  direc- 
tory cylinder  and  the  sector  is  then  read, 

Entry  Conditions: 

A    =85(X'55') 

HL = pointer  to  the  buffer  to  receive  the  sector 

D  =  cylinder  to  read 

E   -sector  to  read 

C  =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  D,  lines  78-92, 
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@RDTRK 


SVC  Number  51 


Read  a  Track 


Reads  an  entire  track  when  supported  by  the  controller  driver.  The  floppy  disk 
driver  supplied  treats  this  as  a  @RDSEC  (SVC  49)  and  does  not  do  a  track 
read. 

Entry  Conditions: 

A    =51  (X'33*) 

HL=pointer  to  buffer  to  receive  the  sector 

D  =  track  to  read 

C   =  logical  drive  number 

E   ~  sector  to  read 

Exit  Conditions: 

Success,  Z  flag  set 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  is  altered  bv  the  sunn!isd  f!onnw  disk  driver. 

Example: 

See  the  example  for  @RDSEC  in  Sample  Program  D,  lines  63-66, 
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READ  SVC  Number  67 


Read  a  Record 


Reads  a  logical  record  from  a  file.  If  the  LRL  defined  at  open  time  was  256 
{specified  by  0),  then  the  NRN  sector  is  transferred  to  the  buffer  established  at 
open  time.  For  LRL  between  1  and  255,  the  next  logical  record  is  placed  into  a 
user  record  buffer,  UREC.  The  3-byte  NRN  is  updated  after  the  read  operation. 

Entry  Conditions: 

A    =67(X'43') 

DE= pointer  to  FOB  for  the  file  to  read 

HL = pointer  to  user  record  buffer  UREC  {needed  if  LRL  =  1-255;  unused  if 
LRL  =  256) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set 
A  -  error  number 

Example: 

See  Sample  Program  C,  lines  300-304, 
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@REMQV       SVC  Number  57 

Remove  File  or  Device 

Removes  a  file  or  device. 

If  a  file  is  to  be  removed,  the  File  Control  Block  must  be  in  an  open  condition. 
When  this  SVC  is  performed,  the  file's  directory  is  updated  and  the  space  occu- 
pied by  the  file  is  deallocated. 

If  a  device  was  specified,  the  device  is  closed.  To  remove  a  device,  use  the 
REMOVE  library  command. 

Entry  Conditions: 

A    =57(Xl39') 

DE = pointer  to  FCB  or  DCB  to  remove 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  =  error  number 

Example: 

See  Sample  Program  C,  lines  223-231. 
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RENAI 


SVC  Number  56 


Rename  File  or  Device 


Changes  a  file's  filename  and/or  extension. 

Entry  Conditions: 

A    =  56(X,38') 

DE=pointerto  an  FCB  containing  the  file's  current  name 

This  FCB  must  be  in  a  closed  state. 
HL= pointer  to  new  filename  string  terminated  with  a  X'W  orX'QSl  This 

filespec  must  be  in  upper  case  and  must  be  a  valid  filespec,  You  can 

convert  the  filespec  to  upper  case  and  check  its  validity  by  using  the 

@FSPEC  SVC  before  using  @RENAM, 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  fiag  set, 
A  ™  error  number 

General: 

After  the  call  is  completed,  the  FCB  pointed  to  by  DE  is  altered, 
Only  AF  is  altered  by  this  SVC. 


SPoint  at  a  closed  FCB 

» c  o  n  t  a  i  n  i  n  3  the  old 

i  f  i 1 espec 

iPoint  to  the  new  filespec 

i to  use 

i Change  the  name  of  the 

if  ile 

iCall  the  §RENAM  SVC 

i  A  File  Control  B 1  a  c  K  used 
Sbv    the  GRENAM  SVC.  In 
i this  example*  it  is 
; assumed  that  an  0FSPEC 
iSVC  has  loaded  a  filespec 
Unto  the  FCB  before  the 
i@RENAM  SYC  is  performed. 
5  The  new  filespec  for  the 
if  ile 
■(Terminate  the  filespec 


Example: 

LD 

DEtFCB 

LD 

HL/NEW 

LD 

A  ,§RENAM 

RST 

2BH 

FCB:  DEFS 

32 

NEN:  DEFM  'NEWNAME/TXT ' 


DEFB  GJDH 
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@REW  SVC  Number  68 


Kewinci  Mie  to  Beginning 


Rewinds  a  file  to  its  beginning  and  resets  the  3-byte  NRN  to  0.  The  next  record 
to  be  read  or  written  sequentially  is  the  first  record  of  the  file. 

Entry  Conditions: 

A    =68(X'44') 

DE^ pointer  to  FCB  for  the  file  to  rewind 

Exit  Conditions: 

Success,  Z  flag  set  File  positioned  to  record  number  0„ 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC„ 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311 
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RIVTTSK SVC  Number  30 

Remove  Interrupt  Level  Task 

Removes  an  interrupt  level  task  from  the  Task  Control  Block  table. 

Entry  Conditions: 

A  =  30(X'1E') 

C = task  slot  assignment  to  remove  (0-1 1 ) 

Exit  Conditions: 

Success  always. 

HL  and  DE  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  F,  lines  134-142, 
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@RPTSK SYC  Number  31 

Replace  Task  Vector 

Exits  the  task  process  executing  and  replaces  the  currently  executing  task's 
vector  address  in  the  Task  Control  Block  table  with  the  address  following  the 
SVC  instruction.  Return  is  made  to  the  foreground  application  that  was 
interrupted,. 

Entry  Conditions: 

A  =  31  (X'1F) 

General: 

This  SVC  does  not  return. 

Example: 

LD    A>RPTSK  ^Replace  this  tasK  with  the 
5  one  located  at  the 
if ol lowintf  add  ress : 
RST   28H      iCall  the  @RPTSK  SVC 
NENADD:  DEFW  0        iAddress  of  the  new  task  is 
iloaded  here*  This  word 
• ,.., , .  r  *  k  -  ,* ,_. «  c  d  i  a  t  c  I  "  after 
;the  §RPTSK  SVC.  The  label 
iNENADD  is  present  only  to 
Sallow  the  address  to  be 
i  sto  red  . 
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REg*B&  span    g&    iwu& 
READ  SVC  Number  69 


Reread  Sector 


Forces  a  reread  of  the  current  sector  to  occur  before  the  next  I/O  request  is  per- 
formed Its  most  probable  use  is  in  applications  that  reuse  the  disk  I/O  buffer  for 
multiple  files,  to  make  sure  that  the  buffer  contains  the  proper  file  sector  This 
routine  is  valid  only  for  byte  I/O  or  blocked  files.  Do  not  use  it  when  positioned 
at  the  start  of  a  file. 

Entry  Conditions: 

A    =  69(X'45') 

DE = pointer  to  FOB  for  the  file  to  reread 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set, 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC, 

Example: 

LD    DEtFCB    iPoint  to  File  Control  BlocK 
i  o  f  the  file  that  requires 
? t he  re- read 

LD    AfSRREAD   before  next  I/O*  reload 
ithe  current  sector  into 
ithe  system  buffer  for 
ithis  file 

RST   Z8H       SCall  the  @RREAD  SMC 
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@RSLCT  SVC  Number  47 

Test  for  Drive  Busy 

Performs  a  test  of  the  last  selected  drive  to  see  if  it  is  in  a  busy  state.  If  busy,  it 
is  re-selected  until  it  is  no  longer  busy. 

Entry  Conditions: 

A=47{X'2F) 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success  always. 

Only  AF  is  altered  by  this  SVC. 

Example: 

LD    C>1        iTest  Driue  1  to  see  if  it 

i  i  s  busy. 
LD    A>@RSLCT   ilf  it  is»  continue 

iselect ins  it 
RST   28H       iCall  the  0RSLCT  SVC 
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@RSTOR SVC  Number  44 

Issue  FDC  RESTORE  Command 

issues  a  disk  controller  RESTORE  command. 

Entry  Conditions: 

A  =  44(X*2C) 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set, 
A  =  error  number 

Example: 

See  the  example  for  @CKDRV  in  Sample  Program  D,  lines  38-39. 
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@RUN SVC  Number  77 

Run  Program 

Loads  and  executes  a  program  file.  If  an  error  occurs  during  the  load,  the  sys- 
tem prints  the  appropriate  message  and  returns. 

Entry  Conditions: 

A    -77(X'4D') 

DE^  pointer  to  FCB  containing  the  filespec  of  the  file  to  RUN 

Note:  The  FCB  must  be  located  where  the  program  being  loaded  will  not 

overwrite  it 

Exit  Conditions: 

Success,  the  new  program  is  loaded  and  executed, 

Failure,  the  error  is  displayed  and  return  is  made  to  your  program. 

HL =  return  code  (See  the  section  "Converting  toTRSDOS  Version  6" 
for  information  on  return  codes,} 

General: 

HL  is  returned  unchanged  if  no  error  occurred  and  can  be  used  as  a 
pointer  to  a  command  line, 

Example: 

See  Sample  Program  A,  lines  62-74 
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RWRIT  SVC  Number  70 


Rewrite  Sector 


Rewrites  the  current  sector,  following  a  write  operation.  The  ©WRITE  function 
advances  the  NRN  after  the  sector  is  written.  @RWRIT  decrements  the  NRN 
and  writes  the  disk  buffer  again,  Do  not  use  @RWRIT  when  positioned  to  the 
start  of  a  file, 

Entry  Conditions: 

A    =70(X'46') 

DE  = pointer  to  FOB  for  the  file  to  rewrite 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  HZ  flag  set. 
A  =  error  number 

Example: 

LD  DE»FCB  iPoint    to    the    File   Control 

i  B 1  o  o  K 
LD  A»@RWRIT      iPerform    a    re-write    of    the 

Jcurrent    sector 
RST       28H  iCall    the    §RWRIT    SVC 


Software  137 


@SEEK  SVC  Number  46 

Seek  a  Cylinder 

Seeks  a  specified  cylinder  and  sector.  @SEEK  does  not  return  an  error  if  you 
specified  a  non-existent  drive  or  an  invalid  cylinder  @SEEK  performs  no  action 
if  the  specified  drive  is  a  hard  disk„ 

Note:  Seek  of  a  sector  is  not  supported  by  TRS-80  hardware.  An  implied  seek 
is  included  in  sector  reads  and  writes. 

Entry  Conditions: 

A  =  46(X'2P) 

C= logical  drive  number 

D=cylindertoseek 

E  =  sector  to  seek 

Exit  Conditions: 

Success  always. 

Only  AF  is  altered  by  this  SVC, 
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SEEKSC SVC  Number  71 

Seek  Cylinder  and  Sector 

Seeks  the  cylinder  and  sector  corresponding  to  the  next  record  of  the  specified 
file.  (This  is  done  by  examining  the  NRN  field  of  the  FCB.)  No  error  is  returned 
on  physical  seek  errors. 

Entry  Conditions: 

A    =71  (X'47') 

DE = pointer  to  the  file's  FCB 

Exit  Conditions: 

Success  always. 

Example: 

LD    DE »FCB    iPoint  to  the  File  Control 
jBIocK 

LD    At@BEEKSC  ICause  the  next  sector  to  be 
iSEEKed  before  it  is 
iactual lv  needed 

RST   28H       iCall  the  ©SEEKSC  SMC 
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SKIP  SVC  Number  72 


Skip  a  Record 


Causes  a  skip  past  the  next  logical  record.  Only  the  record  number  contained 
in  the  FCB  is  changed;  no  physical  I/O  takes  place. 

Entry  Conditions: 

A    =72(X'48") 

DE = pointer  to  FCB  for  the  file  to  skip 

Exit  Conditions: 

If  the  Z  flag  is  set  or  if  A  =  X'1  C  or  X'1  D;  then  the  operation  was  successful 
Otherwise,  A^error  number:  If  A  -  X'1  C  is  returned,  the  file  pointer  is 
positioned  at  the  end  of  the  file  Any  Appending  operations  would  be 
performed  here,  If  A  =  X'1  D'  is  returned,  the  file  pointer  is  positioned 
beyond  the  end  of  the  file. 

General: 

AF  is  altered  by  this  SVC 

BC  contains  the  current  record  number.  This  is  the  same  value  as  that 
returned  by  the  @LOC  SVC, 

Example: 

See  the  example  for  @LOC  in  Sample  Program  C,  lines  305-311 
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SLCT  SVC  Number  41 


Select  a  New  Drive 


Selects  a  drive.  The  time  delay  specified  in  your  configuration  (SYSTEM 
(DELAY  =  Y/N))  is  made  if  the  drive  selection  requires  it 

Entry  Conditions: 

A  =  41  (X'29') 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set, 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC, 
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©SOUND  SVC  Number  104 


Sound  Generation 


Generates  sound  using  specified  tone  and  duration  codes.  Interrupts  are  dis- 
abled during  execution. 

Entry  Conditions: 

A-104(X'68') 

B  =  function  code 

bits  0-2:  tone  selection  (0-7  with  0  =  highest  and  7  =  lowest) 
bits  3-7:  tone  duration  (0-31  with  0  =  shortest  and  31  =  longest) 

Exit  Conditions: 

Success  always. 

Only  AF  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  B,  lines  43-45. 


Software  142 


TEPI SVC  Number  45 

Issue  FDC  STEP  IN  Command 

Issues  a  disk  controller  STEP  IN  command.  This  moves  the  drive  head  to  the 
next  higher-numbered  cylinder  @STEP!  is  intended  for  sequential  read/write 
operations,  such  as  disk  formatting. 

Entry  Conditions: 

A-45(X'2D') 

C  -  logical  drive  number 

Exit  Conditions: 

Success,  Z  flag  set 
Failure,  NZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 
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@TIME  SVC  Number  19 


Get  Time 


Gets  the  system  time  in  display  format  (HH:MM:SS). 

Entry  Conditions: 

A   =19(X'13') 

HL= pointer  to  buffer  to  receive  the  time  string 

Exit  Conditions: 

Success  always, 

HL = pointer  to  the  end  of  buffer  + 1 

DE= pointer  to  start  of  TIMES  storage  area  in  TRSDOS 

AF  and  BC  are  altered  by  this  SVC, 

Example: 

See  the  example  for  @DATE  in  Sample  Program  F,  lines  252-253. 
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SVC  Number  15 


Video  Functions 


Performs  various  functions  related  to  the  video  display.  The  B  register  is  used 
to  pass  the  function  number 

Entry  Conditions: 

A  =  15(X'0F) 

B    selects  one  of  the  following  functions: 

If  B  =  1,  return  the  character  at  the  screen  position  specified  by  HL 
H  =  row  on  the  screen  (0-23),  where  0  is  the  top  row 
L  -  column  on  the  screen  (0-79),  where  0  is  the  leftmost  column 

If  B  =  2,  display  the  specified  character  at  the  position  specified  by 
HL 
C  =  character  to  be  displayed 
H=raw  on  the  screen  (0-23),  where  0  is  the  top  row 
L  -  column  on  the  screen  (0-79),  where  0  is  the  leftmost  column 

If  B  =  3,  move  the  cursor  to  the  position  specified  by  HL  This  is  done 
even  if  the  cursor  is  not  currently  displayed. 
H^row  on  the  screen  (0-23),  where  0  is  the  top  row 
L  -  column  on  the  screen  (0-79),  where  0  is  the  leftmost  column 

If  B  =  4,  return  the  current  position  of  the  cursor 

If  B  -  5,  move  a  1 920-byte  block  of  data  to  video  memory, 
HL~  pointer  to  1 920-byte  buffer  to  move  to  video  memory 

If  B  =  6,  move  a  1 920-byte  block  of  data  from  video  memory  to  a 
buffer  you  supply.  In  40  line  by  24  character  mode,  there  must 
be  a  character  in  each  alternating  byte  for  proper  display 
HL = pointer  to  1 920-byte  buffer  to  store  copy  of  video  memory  HL 
must  be  in  the  range  X'23FF'  <  HL  <  X'ECOI 

If  B  —  7,  scroll  protect  the  specified  number  of  lines  from  the  top  of  the 
screen. 
C  =  number  of  lines  to  scroll  protect  (0-7),  Once  set,  scroll  protect 
can  be  removed  only  by  executing  @VDCTL  with  B  =  7  and 
C  =  Q,  or  by  resetting  the  system.  Clearing  the  screen  with 
(SHlFTHctEAR)  erases  the  data  in  the  scroll  protect  area,  but  the 
scroll  protect  still  exists 

If  B  =  8,  change  cursor  character  to  specified  character.  If  the  cursor 
is  currently  not  displayed,  the  character  is  accepted  anyway 
and  is  used  as  the  cursor  character  when  it  is  turned  back  on. 
The  default  cursor  character  is  an  underscore  (X'5F)  under 
Version  6.2  and  a  X'B0'  under  previous  versions. 
C  =  character  to  use  as  the  cursor  character 

If  B  =  9,  (under  Version  6,2  only)  transfer  80  characters  to  or  from 
the  screen. 
If  C  =  0,  move  characters  from  the  buffer  to  the  screen 
If  C  =  1 ,  move  characters  from  the  screen  to  the  buffer 
H  =  row  on  the  screen 
DE  =  pointer  to  8Q  byte  buffer 

Note:  The  video  RAM  area  in  the  Models  4  and  4P  is  2048  bytes  (2K), 
The  first  1920  bytes  can  be  displayed.  The  remaining  bytes  contain  the 
type-ahead  buffer  and  other  system  buffers 
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Exit  Conditions: 
If  B=  1: 

Success,  Z  flag  set. 

A  =  character  found  at  the  location  specified  by  HL 

DE  is  altered. 
Failure,  NZ  flag  set, 

A  -  error  number 

If  B  =  2: 

Success,  Zflag  set 

DE  is  altered 
Failure,  NZ  flag  set, 

A  -  error  number 

lfB-3: 

Success,  Z  flag  set. 

DE  and  HL  are  altered. 
Failure,  NZ  flag  set. 

A  -  error  number 

If  B  =  4: 

Success  always. 

nL.~~/Gw  ailu  CGtuiTifi  pOoitiGn  Oi   mC  CUrGG'.    »  i"~iw,,   «..  »..« 

screen  (0-23),  where  0  is  the  top  row;  L  =  column  on  the 
screen  (0-79),  where  0  is  the  leftmost  column. 

If  B  =  5: 

Success  always. 

HL= pointer  to  the  last  byte  moved  to  the  video  + 1 
BC  and  DE  are  altered 

lfB-6: 

Success  always 

BC,  DE,  and  HL  are  altered, 

lfB-7: 

Success  always. 

BC  and  DE  are  altered 

If  B  =  8: 

Success  always. 

A- previous  cursor  character 
DE  is  altered. 

If  B  =  9  (under  Version  6.2  only): 
Success,  Z  flag  set. 

BC,  HL,  DE  are  altered 
Failure,  NZ  flag  set  because  H  is  out  of  range. 

A=  error  code  43  (X'2B'). 

General: 

Functions  5,  6,  and  7  do  not  do  range  checking  on  the  entry  parameters. 
If  HL  is  not  in  the  valid  range  in  functions  5  and  6,  the  results  may  be 

unpredictable. 
Only  function  3  (B  =  3)  moves  the  cursor. 
If  C  is  greater  than  7  in  function  7,  it  is  treated  as  modulo  8. 
AF  and  B  are  altered  by  this  SVC. 

Example: 

See  Sample  Program  F,  lines  304-327 
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VER 


SVC  Number  73 


Write  and  Verify  a  Record 


Performs  a  @WR1TE  operation  followed  by  a  test  read  of  the  sector  (if  the  write 
required  physical  I/O)  to  verify  that  it  is  readable. 

If  the  logical  record  length  is  less  than  256,  then  the  logical  record  in  the  user 
buffer  UREC  is  transferred  to  the  file.,  If  the  LRL  is  equal  to  256,  a  full  sector 
write  is  made  using  the  disk  I/O  buffer  identified  at  file  open  time. 

Entry  Conditions: 

A    =73(X'49'} 

DE = pointer  to  FOB  for  the  file  to  verify 

Exit  Conditions: 

Success,  Z  flag  set. 

HL = pointer  to  user  buffer  containing  the  logical  record 
Failure,  NZ  flag  set 

A   -  error  number 

General: 

Only  AF  is  altered  by  this  SVO 

Example: 

See  Sample  Program  C,  lines  338-346. 
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@VRSEC SVC  Number  50 

Verify  Sector 

Verifies  a  sector  without  transferring  any  data  from  disk. 

Entry  Conditions: 

A=50(X'32') 

D= cylinder  to  verify 

E  =  sector  to  verify 

C= logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZflag  set 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC. 

If  the  sector  is  a  system  sector,  the  sector  is  readable  if  an  error  6  is 
returned;  any  other  error  number  signifies  an  error  has  occurred. 

Example: 

See  the  example  for  @WRSEC  in  Sample  Program  D,  lines  68-/fcl 
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WEOF  SVC  Number  74 


Write  End  Of  File 


Forces  the  system  to  update  the  directory  entry  with  the  current  end-of-file 
information. 

Entry  Conditions: 

A    -74(X'4A') 

DE  -  pointer  to  the  FOB  for  the  file  to  WEOF 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set, 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC 

Example: 

LD    DE>FCB    iPoint  at  the  File  Control 

iBlocK 
LD    At§WE0F   iForce  the  directory  entry 

> to  be  updated  now  t 

iinstead  of  when  the  file 

?  is  closed 
RST   28H       SCall  the  @NE0F  BUC 
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©WHERE SVC  Number  7 

Locate  Origin  of  SVC 


Used  to  resolve  the  relocation  address  of  the  calling  routine 

Entry  Conditions: 

A  =  7(X'07') 

Exit  Conditions: 

Success  always, 

HL^ pointer  to  address  following  RST  28 H  instruction 
AF  is  always  altered  by  this  SVC 

Example: 

See  Sample  Program  F,  lines  36-60, 
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©WRITE 


SVC  Number  75 


Write  a  Record 


Causes  a  write  to  the  next  record  identified  in  the  File  Control  Block. 

If  the  logical  record  length  is  less  than  256,  then  the  logical  record  in  the  user 
buffer  UREC  is  transferred  to  the  file.  If  the  LRL  is  equal  to  256,  a  full  sector 
write  is  made  using  the  disk  I/O  buffer  identified  at  file  open  time. 

Entry  Conditions: 

A    =75(X'4B') 

HL^  pointer  to  user  record  buffer  UREC  (unused  if  LRL  =  256) 

DE= pointer  to  FCB  for  the  file  to  write 

Exit  Conditions: 

Success,  2  flag  set. 
Failure,  NZ  flag  set, 
A  =  error  number 

General: 

AF  is  always  altered  by  this  SVC 

Example: 

See  the  example  for  @VER  in  Sample  Program  C,  lines  338-346, 
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@WRSEC       SVC  Number  53 


Write  a  Sector 


Writes  a  sector  to  the  disk. 

Entry  Conditions: 

A    =  53(X'35') 

HL = pointer  to  the  buffer  containing  the  sector  of  data 

D  ^cylinder  to  write 

E   -  sector  to  write 

C  ^logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  HZ  flag  set. 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 

Example: 

See  Sample  Program  D,  lines  66-76. 
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@WRSSC SVC  Number  54 

Write  a  System  Sector 

Writes  a  system  sector  (used  in  directory  cylinder) 

Entry  Conditions: 

A    -54(X'36') 

HL = pointer  to  the  buffer  containing  the  sector  of  data 

D  =  cylinder  to  write 

E   -  sector  to  write 

C  =  logical  drive  number 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set. 
A  -  error  number 

General: 

Only  AF  is  altered  by  this  SVC, 

Example: 

See  Sample  Program  D,  lines  94-104. 
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@WRTRK  SVC  Number  55 

Write  a  Track 

Writes  an  entire  track  of  properly  formatted  data.  The  data  format  must  conform 
to  that  described  in  the  disk  controller's  reference  manual  @WRTRK  must 
always  be  preceded  by  @SLCT 

Entry  Conditions; 

A   =55<X,37') 
HL^pointer  to  format  data 
D  =  track  to  write 
C  =  logical  drive  number  (0-7) 

Exit  Conditions: 

Success,  Z  flag  set. 
Failure,  NZ  flag  set 
A  =  error  number 

General: 

Only  AF  is  altered  by  this  SVC. 
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Numerical  List  of  SVCs 


Following  is  a  numerical  list  of  the  SVCs: 
Dec         Hex  Label 


Function 


0 

00 

@IPL 

Reboot  the  system 

1 

01 

@KEY 

Scan  *KI  device,  wait  for  character 

2 

02 

@DSP 

Display  character  at  cursor,  advance 
cursor 

3 

03 

@GET 

Get  one  byte  from  a  logical  device 

4 

04 

@PUT 

Write  one  byte  to  a  logical  device 

5 

05 

@CTL 

Make  a  control  request  to  a  logical 
device 

6 

06 

@PRT 

Send  character  to  the  line  printer 

7 

07 

@WHERE 

Locate  origin  of  CALL 

8 

08 

@KBD 

Scan  keyboard  and  return 

9 

09 

@KEYIN 

Accept  a  line  of  input 

10 

0A 

@DSPLY 

Display  a  message  line 

11 

0B 

(©LOGER 

Issue  a  log  message 

12 

0C 

@LOGOT 

Display  and  log  a  message 

13 

0D 

@MSG 

Message  line  handler 

14 

0E 

@PRINT 

Print  a  message  line 

15 

0F 

@VDCTL 

Position/locate  cursor,  get/put  char- 
acter at  cursor 

16 

10 

©PAUSE 

Suspend  program  execution 

17 

11 

@PARAM 

Parse  an  optional  parameter  string 

18 

12 

@DATE 

Get  system  date  in  the  format  MM/ 
DD/YY 

19 

13 

@TIME 

Get  system  time  in  the  format 
HH:MM:SS 

20 

14 

@CHNIO 

Pass  control  to  the  next  module  in  a 
device  chain 

21 

15 

@ABORT 

Load  HL  with  X'FFFF'  error  and  goto 
@EXIT 

22 

16 

@EXIT 

Exit  program  and  return  to  TRSDOS 

23 

Reserved  for  future  use 

24 

18 

@CMNDI 

Entry  to  command  interpreter  with 
return  to  the  system 

25 

19 

@CMNDR 

Entry  to  command  interpreter  with 
return  to  the  user 

26 

1A 

@ERROR 

Entry  to  post  an  error  message 

27 

1B 

©DEBUG 

Enter  DEBUG 

28 

1C 

@CKTSK 

Check  if  task  slot  in  use 

29 

1D 

@ADTSK 

Add  an  interrupt  level  task 

30 

1E 

@RMTSK 

Remove  an  interrupt  level  task 

31 

1F 

@RPTSK 

Replace  the  currently  executing  task 
vector 

32 

20 

@KLTSK 

Remove  the  currently  executing  task 

33 

21 

@CKDRV 

Check  for  drive  availability 

34 

22 

@DODIR 

Do  a  directory  display/buffer 

35 

23 

@RAMD!R 

Get  directory  record (s)  or  free  space 
into  RAM 

3-39 

Reserved  for  future  use 

40 

28 

@DCSTAT 

Test  if  drive  is  assigned  in  DCT 

41 

29 

@SLCT 

Select  a  new  drive 

42 

2A 

@DCINlT 

Initialize  the  FDC 

43 

2B 

@DCRES 

Reset  the  FDC 

44 

2C 

@RSTOR 

issue  FDC  RESTORE  command 

45 

2D 

@STEPI 

Issue  FDC  STEP  IN  command 
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Dec 


Hex 


Label 


AC 

2E 

©SEEK 

47 

2F 

@RSLCT 

48 

30 

@RDHDR 

49 

31 

@RDSEC 

50 

32 

(o)VRSEC 

51 

33 

@RDTRK 

52 

34 

@HDFMT 

53 

35 

@WRSEC 

54 

36 

(o>WRSSC 

55 

37 

(&WRTRK 

56 

38 

@RENAM 

57 

39 

@REMOV 

58 

3A 

@INIT 

59 

3B 

@OPEN 

60 

3C 

@CLOSE 

61 

3D 

@BKSP 

62 

3E 

@CKEOF 

63 

3F 

@LOC 

64 

40 

@LOF 

65 

41 

@PEOF 

66 

42 

(&POSN 

67 

43 

©READ 

68 

44 

@REW 

69 

45 

@RREAD 

70 

46 

@RWRiT 

71 

47 

(o)SEEKSC 

72 

48 

@SKIP 

73 

49 

@VER 

74 

4A 

@WEOF 

75 

4B 

@WRITE 

76 

4C 

@LOAD 

77 

4D 

@RUN 

78 

4E 

@FSPEC 

79 

4F 

@FEXT 

80 

50 

@FNAME 

81 

51 

@GTDCT 

82 

52 

@GTDCB 

83 

53 

@GTMOD 

84 

85 

55 

@RDSSC 

86 

87 

57 

@D!RRD 

88 

58 

@DiRWR 

89 

90 

5A 

@MUL8 

91 

5B 

@MUL16 

92 

93 

5D 

@DIV8 

94 

5E 

@DIV16 

95 

96 

60 

@DECHEX 

97 

61 

@HEXDEC 

Function 

Seek  a  cylinder 

Test  if  requested  drive  is  busy 

Read  a  sector  header 

Read  a  sector 

Verify  a  sector 

Read  a  track 

Hard  disk  format 

Write  a  sector 

Write  a  system  sector 

Write  a  track 

Rename  a  file 

Remove  a  file  or  device 

Open  or  initialize  a  file  or  device 

Open  an  existing  file  or  device 

Close  a  file  or  device 

Backspace  one  logical  record 

Check  for  end  of  file 

Calculate  the  current  logical  record 

number 

Calculate  the  EOF  logical  record 

Position  to  the  end  of  file 

Position  a  file  to  a  logical  record 

Read  a  record  from  a  file 

Rewind  a  file  to  its  beginning 

Reread  the  current  sector 

Rewrite  the  current  sector 

Seek  a  specified  cylinder  and  sector 

Skip  the  next  record 

Write  a  record  to  a  file  and  verify 

Write  end  of  file 

Write  a  record  to  a  file 

Load  a  program  file 

Load  and  execute  a  program  file 

Fetch  a  file  or  device  specification 

Set  up  a  default  file  extension 

Fetch    filename/extension   from 

directory 

Get  Drive  Code  Table  address 

Find  specified  or  first  free  DCB 

Find  specified  memory  module 

address 

Reserved  for  future  use 

Read  a  system  sector 

Reserved  for  future  use 

Read  directory  record 

Write  directory  record 

Reserved  for  future  use 

Multiply  8-bit  unsigned  integers 

Multiply  16-bit  by  8-bit  unsigned 

integers 

Reserved  for  future  use 

Divide  8-bit  unsigned  integers 

Divide  16-bit  by  8-bit  unsigned 

integers 

Reserved  for  future  use 

Convert  decimal  ASCI!  to  16-bit 

binary  value 

Convert  a  number  in  HL  to  decimal 

ASCII 
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Dec 


Hex 


Label 


Function 


98 

99 

100 

62 
63 
64 

@HEX8 

@HEX16 

@HIGH$ 

101 
102 

65 
66 

@FLAGS 
@BANK 

103 

104 

105-127 

67 
68 

@BREAK 
@SOUND 

Convert  a  1-byte  number  to  hex  ASCII 
Convert  a  2-byte  number  to  hex  ASCM 
Obtain  or  set  the  highest  and  lowest 
unused  RAM  addresses 
Point  IY  to  the  system  flag  table 
Check,  set,  or  reset  a  32K  bank  of 
memory 

Set  user  or  system  break  vector 
Generate  sound  (tone  and  duration) 
Reserved  for  future  use. 
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Alphabetical  List  of  SVCs 


Following  is  an  alphabetical  list  of  the  SVC  labels  and  numbers: 

Label  Dec  Hex 


@ABORT 

21 

15 

@ADTSK 

29 

1D 

@BANK 

102 

66 

@BKSP 

61 

3D 

@BREAK 

103 

67 

@CHNiO 

20 

14 

@CKDRV 

33 

21 

@CKEOF 

62 

3E 

@CKTSK 

28 

1C 

@CLOSE 

60 

3C 

@CMNDI 

24 

18 

@CMNDR 

25 

19 

@CTL 

5 

5 

@DATE 

18 

12 

(o)DCINIT 

42 

2A 

@DCRES 

43 

2B 

@DCSTAT 

40 

28 

©DEBUG 

27 

1B 

@DECHEX 

96 

60 

@DIRRD 

87 

57 

@DIRWR 

88 

58 

@DIV8 

93 

5D 

@DIV16 

94 

5E 

@DODIR 

34 

22 

@DSP 

2 

2 

@DSPLY 

10 

0A 

@ERROR 

26 

1A 

@EX!T 

22 

16 

@FEXT 

79 

4F 

@FLAGS 

101 

65 

(a>FNAME 

80 

50 

@FSPEC 

78 

4E 

@GET 

3 

3 

@GTDCB 

82 

52 

@GTDCT 

81 

51 

@GTMOD 

83 

53 

@HDFMT 

52 

34 

@HEXDEC 

97 

61 

@HEX8 

98 

62 

@HEX16 

99 

63 

@HIGH$ 

100 

64 

@INIT 

58 

3A 

@IPL 

0 

0 

@KBD 

8 

8 

@KEY 

1 

1 

@KEYIN 

9 

9 

@KLTSK 

32 

20 

©LOAD 

76 

4C 

@LOC 

63 

3F 

@LOF 

64 

40 

@LOGER 

11 

0B 

@LOGOT 

12 

0C 

OMSG 

13 

0D 
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Label  Dec  Hex 

@MUL8 

@MUL16 

@OPEN 

@PARAM 

@PAUSE 

@PEOF 

@POSN 

©PRINT 

@PRT 

@PUT 

@RAMDIR 

@RDHDR 

@RDSEC 

@RDSSC 

@RDTRK 

@READ 

@REMOV 

@RENAM 

@REW 

@RMTSK 

@RPTSK 

@RREAD 

@RSLCT 

@RSTOR 

@RUN 

@RWRIT 

@SEEK 

@SEEKSC 

@SKiP 

@SLCT 

@SOUND 

@STEPi 

@TIME 

@VDCTL 

@VER 

@VRSEC 

@WEOF 

@WHERE 

©WRITE 

@WRSEC 

@WRSSC 

@WRTRK 


90 

5A 

91 

5B 

59 

3B 

17 

11 

16 

10 

65 

41 

66 

42 

14 

0E 

6 

6 

4 

4 

35 

23 

48 

30 

49 

31 

85 

55 

51 

33 

67 

43 

57 

39 

56 

38 

68 

44 

30 

1E 

31 

1F 

69 

45 

47 

2F 

44 

2C 

77 

4D 

70 

46 

46 

2E 

71 

47 

72 

48 

41 

29 

1 04 

68 

45 

2D 

19 

13 

15 

OF 

73 

49 

50 

32 

74 

4A 

7 

7 

75 

4B 

53 

35 

54 

36 

55 

37 
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Sample  Programs 


The  following  sample  programs  use  many  of 
the  supervisor  calls  described  in  this  man- 
ual. These  programs  are  not  meant  to  be 
examples  of  the  most  efficient  programming, 
but  are  designed  to  illustrate  as  many  super- 
visor calls  as  possible, 
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Sample  Program  A 


Ln  # 

00001 
00002 
03 
24 
00005 
00001 


39 
00010 
LI 
L2 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
0002  4 
25 
26 
00027 
00028 
00029 


00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
0003  9 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
00053 
0005  4 
00055 
00056 
00057 

0005  8 
00059 
00060 
00061 

0006  2 
00063 
0006  4 

65 
56 
57 


@DEBUG: 
@DSPLY: 
@FSPEC: 

<§KEY: 

@LOAD: 

@RUN: 


Source  Line 

This  program  asks  the  user  whether  to  run  a  program 
or  debug  it  and  executes  the  SVCs  required  to  perform 
the  chosen  action, 

PSECT    5000H  ;The  program  begins  at  x'5000' 

Define  the  equates  for  the  SVCs  that  will  be  used, 

27 

10 
78 


EQU 
EQU 
EQU 


EQU 
EQU 
EQU 

DEFM 
DEFB 
DEFM 
DEFB 

DEFM 
DEFB 


1 
76 

77 


;Enter  the  debugger   (DEBUG) 

;Display  a  message 

;Verify  a  filespec  or  devspec  and 

;load  it  into  a  File  Control  Block 

?Get  a  character  from  the  keyboard 

;Load  a  program  into  memory 

; Execute  a  program 


'Do  you  wish  to  RUN  this  Program  or  DEBUG  it  ?' 

0AH  ;This  moves  the  cursor  to  the  next  line 

'Press  <ENTER>  to  RUN  or  <BREAK>  to  DEBUG' 

0DH  ;Terminate  the  message  string 


'DIREX/CMD' 
0DH 


; Sample  program  to  debug  or  execute 
;Terminate  the  filespec 


DEFS     32  ;File  Control  Block  for  the  program 

Get  the  File  Control  Block  for  the  program  'DIREX/CMD' . 


START :   LD 


LD 
LD 


LD 
LD 
RST 

LD 
RST 

CP 
JR 


HL,PROGRM  ; Point  at  the  filespec  we  want  to 
;execute  or  load  into  memory 

DE,FCB1  ;Point  at  the  File  Control  Block 

A,@FSPEC  ;Perform  a  validity  check  on  the  filespec 
;and  copy  the  filespec  into  the  FCB. 

28H  ;Call  the  @FSPEC  svc 

HL,MESS1  ; Point  at  our  prompting  message 

A,@DSPLY  ;and  print  it  on  the  display 

28H  ;Call  the  @DSPLY  svc 

A,@KEY  ;Get  the  reply  from  the  keyboard 

28H  ;Call  the  @KEY  svc 

0DH  ;Was  the  character  an  <ENTER>? 

Z,RUNIT  ;If  Z  was  set,  then  run  the  program 


If  it  wasn't  an  <ENTER>,  then  we  assume  it  was  a  <BREAK>  and 
load  the  program  and  enter  the  debugger . 


LD  DE,FCBl 
LD  A, § LOAD 
RST      28H 


;Point  at  the  File  Control  Block 

;and  have  this  program  loaded  into  memory 

;Call  the  @LOAD  svc 


Note  that  this  program  must  not  be  overwritten  by  the  program 
we  are  loading.   In  this  example,  it  is  known  that  the  program 
we  are  loading  starts  at  x'3000'  and  ends  below  x'5000'. 


LD 
RST 


A,@DEBUG 
28H 


Execute  the  program 


LD 
LD 


DE,FCBl 
A,@RUN 


28H 


;Now  invoke  the  system  debugger,  DEBUG 

;Call  the  @DEBUG  svc 

;Note  that  QDEBUG  does  not  return 


;Point  at  the  File  Control  Block 

;Tell  TRSDOS  to  load  and  execute  the 

;program 

;Call  the  @RUN  svc 
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Sample  Program  A,  continued 


;Note  that  @RUN  returns  only  if  it  can't 
00069  ;find  the  program 

00070 

00071  ;       Note  that  the  program  that  is  loaded  by  the  @RUN  svc  must  not 

00072  ;       overwrite  the  File  Control  Block  in  this  program.   In  this  case, 

00073  ;       it  is  known  that  the  program  we  are  executing  starts  at  x'3000* 

00074  ;       and  ends  below  the  starting  point  of  this  program, 
00075 
00076  END      START 
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Sample  Program  B 


00001 


00007 


00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
00053 
0005  4 
00055 
00056 
00057 
00058 
0005  9 


00061 
0006  2 
0006  3 
0006  4 
55 
56 
00067 


;This  program  accepts  numbers  from  the  keyboard 
;and  uses  them  to  demonstrate  the 
arithmetic  and  numeric  conversion  SVCs. 

; It  also  uses  the  sound  function  to  produce  a  tone  at  the 
^beginning  of  the  program. 

PSECT    3000H 

;       These  are  the  SVCs  used  in  this  program. 


@DECHEX:EQU 
@DIV8:  EQQ 
@DIV16 
@DSP: 
@DSPLY 
@EXIT: 
@HEX8: 
@HEX16 
@HEXDEC:EQU 
@KEY:  BQU 
@KEYIN:  EQU 
@MDL8 :  EQU 
@MUL16:  EQU 
@ SOUND:  EQU 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


96 
93 
94 
2 

10 

22 

98 

99 

97 

1 

9 

90 

91 

104 


;Convert  decimal  ASCII  to  binary 

;Perform  8~bit  division 

;Perform  16-bit  division 

;Display  a  character 

;Display  a  message 

;Return  to  TRSDOS  Ready  or  the  caller 

;Convert  an  8-bit  value  to  hex  ASCII 

;Convert  a  16-bit  value  to  hex  ASCII 

;Convert  a  binary  value  to  Decimal  ASCII 

;Read  a  character  from  *KI 

;Accept  an  input  line  from  *KI 

^Perform  8-bit  multiplication 

;Perform  16-bit  multiplication 

;Produce  a  tone 


Other  equates. 


NUM5: 

NUM4: 

NUM3: 

NUM2: 

NUM1: 

BRK: 

CCC: 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


5 

4 

3 

2 

1 

80H 

0DH 


;Character  code  for  <BREAK>  key 
;Next  line  position 


; Perform  a  subroutine  2  times  to  display  prompting  messages, 
;and  display  divisor  and  dividend,  convert  those  numbers  to 
; binary  for  the  divide,  and  position  the  cursor. 


key 


LD 

LD 

RST 

CALL 

LD 

LD 

LD 

CALL 

LD 

LD 

CALL 

CALL 

LD 

LD 


B,5AH 

A,@SOUND 

28H 

KEYIN 

A,C 

(DIVD1) ,A 

HL,MESS9 

DSPLAY 

A,  (DIVD1) 

C,A 

HEX8 

KEYID3 

A,C 

(DIVR1) ,A 


;Now  we  are  ready  to  perform  the 

LD  C,A 

LD  A,(DIVD1> 

LD  E,A 

LD  A,@DIV8 

RST  28H 

;Now  display  the  answer  and  the 

LD       (ANSI) ,A 


;Make  the  longest,  hiqhest  tone 
;Make  the  noise 

^Perform  keyin  subroutine  for  dividend 

;Store  the  dividend  in  memory 

; Address  of  hex  message 

;Display  hex  message 

;Get  the  divisor  into  C  for  conversion 

;from  binary  to  hex 
;Convert  the  number  to  hex 

;Perform  subroutine  for  divisor 

;Store  the  divisor  in  memory 

divide  on  the  numbers  entered. 

;Put  the  divisor  back  for  the  @DIV8  SVC 
;Get  the  dividend  into  E 
;for  the  @DIV8  SVC 
;Call  the  @DIV8  SVC 


remainder  in  decimal. 
;Store  the  answer  in  memory 
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Sample  Program  B,  continued 


0006  9 
00070 
00071 
00072 
00073 

0007  4 
00075 
00076 
0007  7 
00078 
0007  9 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 
00089 
00090 
00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 
00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 
0012  4 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
00132 
00133 
00134 
00135 


LD 

A,E 

LD 

(REM!) .A 

LD 

HL,MESS3 

CALL 

DSPLAY 

LD 

A , ( ANS 1 ) 

LD 

L,A 

LD 

H,0 

CALL 

HEXDEC 

LD 

HL,MESS4 

CALL 

DSPLAY 

LD 

A, (REM1) 

LD 

L,A 

LD 

H,0 

CALL 

HEXDEC 

ide  wi 

th  a  16-bit  a 

LD 

HL,MESS6 

CALL 

DSPLAY 

LD 

A,@KEYIN 

LD 

HL,BUF6 

LD 

B,NUM5 

LD 

C,0 

RST 

28H 

LD 

A,@DECHEX 

RST 

28H 

LD 

(DIVD2) ,BC 

LD 

HL,MESS9 

CALL 

DSPLAY 

LD 

DE, CDIVD2) 

CALL 

HEX16 

CALL 

KEY  IN 

LD 

A,C 

LD 

(DIVR1) ,A 

LD 

HL,MESS3 

CALL 

DSPLAY 

LD 

HL, (DIVD2) 

LD 

A, (DIVR1) 

LD 

C,A 

LD 

A,@DIV16 

RST 

28H 

LD 

(REM1) ,A 

LD 

(ANS2) ,HL 

CALL 

HEXDEC 

LD 

HL,MESS4 

CALL 

DSPLAY 

LD 

A, (REM1) 

LD 

L,A 

LD 

H/0 

CALL 

HEXDEC 

t   some 

multiplicatio 

LD 

HL,MESS8 

CALL 

DSPLAY 

LD 

A,@KEYIN 

LD 

HL,BUF2 

LD 

B,NUM2 

LD 

C,0 

RST 

28H 

LD 

A,@DECHEX 

RST 

28H 

LD 

(MCAND1) ,BC 

LD 

HL,MESS10 

CALL 

DSPLAY 

LD 

A,@KEYIN 

LD 

HL,BUF2 

;Get  the  remainder 

;  Store  the  remainder  in  memory 

;Load  address  of  answer  message 

;Display  the  message 

;Get  the  answer  into  L  for  conversion 

;Number  to  convert 

;Put  a  0  in  the  MSB 

;Perform  subroutine  to  display  decimal  value 

;Address  of  remainder  message 

; Display  remainder  message 

;Put  remainder  in  A  for  hex  conversion 

; Number  to  convert 

;Put  0  in  the  MSB 

;Display  decimal  value 


; Address  of  2nd  dividend  message 
;Display  next  message 
;Key  in  up  to  5  digits 
;Store  the  number 
;Maximum  length  of  number 


;Convert  the  number  to  binary 

; Store  the  dividend 

;Address  of  hex  message 

; Display  hex  message 

;Put  dividend  into  DE  for  conversion 

;Convert  the  number  from  binary  to  hex 

;Key  in  divisor 

;Put  the  divisor  into  A 

;Store  the  divisor  in  memory 

; Address  of  answer  message 

;Display  the  message 

;Put  dividend  into  HL 

;Get  divisor  into  C 


; Store  the  remainder 

;Put  the  answer  into  HL 

; Display  answer  in  decimal 

;Address  of  remainder  message 

; Display  remainder  message 

;Get  the  remainder 

;into  L 

;Put  a  0  in  MSB 

;Convert  the  remainder  to  decimal 


; Address  o£  MUL8  message 

;Display  first  multiplicand  message 

;Key  in  a  2-digit  number 

;Put  it  here 

;Maximum  number  of  characters 


;Convert  the  number  to  binary  for  math 

;Store  the  multiplicand 

;Address  of  MUL8  multiplier  message 

;Display  first  multiplier  message 

;Key  in  the  multiplier 

;Put  it  here 
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Sample  Program  B,  continued 


00136 

LD 

B,NUM1 

00137 

LD 

C0 

00138 

RST 

28H 

00139 

LD 

A,@DECHEX 

00140 

RST 

28H 

00141 

LD 

(MIERl) ,BC 

00142 

LD 

HL,MESS13 

00143 

LD 

A,(§DSPLY 

00144 

RST 

28H 

00145 

00146 

;Now  multiply 

the  two  numbej 

00147 

00148 

LD 

A, (MCANDl) 

00149 

LD 

C,A 

00150 

LD 

A, (MIERl) 

00151 

LD 

E,A 

00152 

LD 

A,@MUL8 

00153 

RST 

28H 

00154 

LD 

L,A 

00155 

LD 

H,0 

00156 

CALL 

HEXDEC 

00157 

00158 

;Now  multiply 

a  16~bit  by  aj 

00159 

00160 

LD 

HL,MESSU 

00161 

CALL 

DSPLAY 

00162 

LD 

A,@KEYIN 

00163 

LD 

HL,BUF5 

00164 

LD 

B,NUM4 

00165 

LD 

C,0 

00166 

RST 

28H 

00167 

LD 

A,@DECHEX 

00168 

RST 

28H 

00169 

LD 

(MCAND2) ,BC 

00170 

LD 

HL,MESS12 

00171 

CALL 

DSPLAY 

00172 

LD 

A,@KEYIN 

00173 

LD 

HL,BUF3 

00174 

LD 

B,NUM2 

00175 

LD 

C,0 

00176 

RST 

28H 

00177 

LD 

A,@DECHEX 

00178 

RST 

28H 

00179 

LD 

(MIERl) ,BC 

00180 

LD 

HL,MESS13 

00181 

LD 

A,@DSPLY 

00182 

RST 

28H 

00183 

LD 

HL, (MCAND2) 

00184 

LD 

A/ (MIERl) 

00185 

LD 

C,A 

00186 

LD 

A,@MUL16 

00187 

RST 

28H 

00188 

LD 

H,L 

00189 

00190 

LD 

L,A 

00191 

LD 

DE,BUF5 

00192 

LD 

A,  @ HEXDEC 

00193 

RST 

28H 

00194 

LD 

A,CCC 

00195 

LD 

(DE) ,A 

00196 

LD 

HL,BUF5 

00197 

LD 

A,@DSPL¥ 

00198 

RST 

28H 

00199 

LD 

HL,MESS14 

00200 

LD 

A,§DSPLY 

00201 

RST 

28H 

00202 

LD 

A,@KEY 

00203 

RST 

28H 

;Maximum  number  of  characters 


;Convert  the  multiplier  to  binary  for  math 

;Store  multiplier  in  memory 
;Address  of  multiplier  message 
;Display  multiplier  message 


;Get  the  multiplicand  into  C 
;Get  the  multiplier  into  E 


;Put  the  product  into  L 

;Put  0  in  the  MSB 

;Convert   the   product   to  decimal 


8-bit . 


;Address  of  multiplicand  message 

;Display  2nd  multiplicand  message 

; Enter  larger  multiplicand 

;Put  it  here 

;Maximum  number  of  characters 


;Convert  the  number  to  binary  for  math 

;Store  the  multiplicand  in  memory 

;Address  of  multiplier  message 

;Display  message 

;Enter  larger  multiplier 

;Put  it  here 

;Maximum  number  of  characters 


;Convert  the  number  to  binary  for  math 

;Store  the  multiplier  in  memory 
;Address  of  product  message 

;Display  the  message 

;Put  multiplicand  into  HL 
;Get  the  multiplier  into  C 

; Multiply  the  two  numbers 

;Get  the  2nd  byte  of  the  product  into 
;H  for  conversion 

;Get  the  LSB  into  L  for  conversion 
;Convert  the  high-order  byte  to  decimal 
; for  the  display 

;Tell  the  display  when  to  stop 


;Display  the  product 

;Address  of  end  message 
;Display  end  message 

;Allow  the  user  to  enter  any  character 
;or  hit  <BREAK> 
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Sample  Program  B,  continued 


00204 
00205 
00206 
00207 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00218 
00219 
00220 
00221 
00222 
00223 
00224 
00225 
00226 
00227 
00228 
00229 
00230 
00231 
00232 
00233 
00234 
00235 
00236 
00237 
00238 
002  39 
00240 
00241 
00242 

0024  3 
00244 
00245 
00246 
00247 
00248 
00249 
00250 
00251 

0025  2 

0025  3 
00254 
00255 
00256 
00257 
00258 
00259 
00260 
00261 
00262 

0026  3 
00264 
00265 
00266 
00267 
00268 
00269 
00270 
00271 


CP 

BRK 

Jp 

NZ, START 

LD 

A,@EXIT 

RST 

28H 

;Is  it  <BREAK>? 

;Ye3/  go  back  to  beginning 

;No,  exit  the  program 


;These  are  the  subroutines  used  by  the  calls  to 

;display  a  message,  key  in  a  3-digit  number/  and  convert  it 

;from  decimal  to  binary. 


KEYIN:   LD 

CALL 

LD 

LD 

LD 

LD 

RST 

LD 

RST 

RET 


HL/MESSl 

DSPLAY 

HL,BUF4 

B,NUM3 

C,0 

A, @ KEYIM 

28H 

A,@DECHEX 

28H 


; Display  message 
;Put  the  number  here 
;Maximum  number  of  characters 


;Key  in  a  number 
;Convert  the  number  to  binary 
;Return  to  next  sequential  instruction 
Display  what  was  loaded  into  HL  before  the  call. 

; ©DISPLAY  SVC 


DSPLAY:  LD 
RST 
DEC 
LD 

DSPLYLP:LD 
LD 
RST 
DJNZ 
RET 


A,@DSPLY 

28H 

HL 

B, (HL) 

C,  '  * 

A,@DSP 

28H 

DSPLYLP 


;Convert  1  byte  to  hexadecimal . 


HEX8: 


LD 

LD 

RST 

LD 

LD 

LD 

LD 

RST 

RET 


A,@HEX8 
HL,BUF3 
28H 

A,CCC 
(HL) ,A 
A,@DSPLY 
HL,BUF3 
28H 


;Set  HL  back  to  blank  byte 

;Load  B  with  the  number  of  bytes 

;Put  a  blank  into  C 

;Display  the  blank 

; until  the  correct  number 

;of  blanks  have  been  displayed 

; Return  to  next  instruction 


;Convert  1  byte  to  hex  ASCII 
;Put  the  converted  value  here 

;Tell  display  when  to  stop 
;Put  CCC  at  end  of  buffer 
;Display  the  hex  value 


;Return  to  next  instruction 


;Convert  2  bytes  to  hexadecimal. 


HEX16 :  LD 
LD 
RST 
LD 
LD 
LD 
LD 
RST 
RET 


A,@HEX16 

HL,BUF6 

28H 

A,  CCC 

(HL) ,A 

A/@DSPLY 

HL,BUF6 

28H 


;Convert  a  2-byte  number  to  hex  ASCII 
;Put  the  converted  value  here 

;CCC  at  end  of  buffer  so  display 
;knows  when  to  stop 
; Display  the  converted  value 
; Address  of  converted  value 


;Return  to  next  instruction 
Convert  from  binary  to  decimal  and  display  decimal  value. 


HEXDEC :  LD 
LD 
RST 
LD 
LD 
LD 
LD 
RST 
RET 


A,@HEXDEC 

DE,BUF5 

28H 

A  ,CCC 

(DE) ,A 

A,@DSPLY 

HLrBUF5 

28H 


^Convert  from  binary  to  decimal 
;Put  converted  value  here 

;CCC  at  end  of  buffer  so  display 
;knows  when  to  stop 
;Display  the  hex  value 
;It's  here 

;Return  to  next  instruction 
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Sample  Program  B,  continued 


00212 
00213 
00214 
00215 
0021 S 
00211 
00218 
00219 
0J3T280 
00281 
00282 
00283 
00284 
00285 
00286 
00287 
00288 
00289 
00290 
00291 
00292 
00293 
00294 
002  95 
00296 
00297 
00298 
00299 


;These  are  the  storage  declarations. 


00301 
00302 
00303 
00304 
00305 
00306 
00307 


00309 
00310 
00311 
00312 
00313 
00314 
00315 
00316 
00317 
00318 
00319 
00320 
00321 
00322 
00323 


BUP6: 

BUF5 

BUF4: 

B0F3: 

BUF2: 

DIVR1: 

DIVD1: 

ANSI: 

REM1: 

MCAND1: 

MIERl: 

MCAND2: 

DIVD2: 

ANS2: 


DEFS 
DEFS 

DEFS 
DEFS 
DEFS 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFW 
DEFW 
DEFW 


0 


;Below  are  messages  and  prompting  text  used  in  the  program. 


MESS1: 


MESS8: 
MESS9: 

MESS10: 

MESS11: 

MESS12: 
MESS13: 
MESS14: 


DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 

END 


13 

'Enter  a  number 

3 

21 

'The  answer  is' 

3 

18 


^Number  of  blanks  to  print  after  message  1 

(1-255)  .' 

; Message- terminating  character 

;Number  of  blanks  to  print  after  message  3 

terminating  character 

;Blanks  after  message 


'The  remainder  is' 

3  terminating  character 

6  ?Blanks  after  message 

'Enter  a  number  (4369-65535),' 

3  terminating  character 

15  ;Blanks  after  message 
'Enter  a  number  {1-28).' 

3  terminating  character 

16  ;Blanks  after  message 
'In  hex  ASCII,  that  is' 

3  terminating  character 

17  ;Blanks  after  message 
'Enter  a  number  (1-9).' 

3  terminating  character 

11  ;Blanks  after  message 

•Enter  a  number  (1-4100).' 

3  .'Terminating  character 

15  ;Blanks  after  message 

'Enter  a  number  (1-15).' 

3  terminating  character 

'The  product  of  those  2  numbers  is  ' 

3  ^Terminating  character 

'Press  <BREAK>  to  end  or  any  other  key  to  continue,' 

0DH  .-Terminating  character 

START 
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Ln..# 
00001 


00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
0002  2 

0002  4 
00025 
00026 
00027 
00028 

0002  9 
00030 
00031 

0003  2 
0003  3 
0003  4 
0003  5 
00036 
0003  7 
0003  8 

0003  9 
00040 
00041 
00042 
00043 

0004  4 
00045 


00048 
00049 
00050 
00051 
0005  2 
0005  3 
0005  4 
0005  5 
00056 
00057 
0005  8 

0005  9 
00060 
00061 

0006  2 
0006  3 
0006  4 
0006  5 
0006  6 
00067 


Source.'  Line  ~\, 

This  program  prompts  for  two  filenames/  opens  the  first 
file,  and  creates  the  second.   Then  the  data  in  the  first 
file  is  copied  to  the  second  file.   While  the  Copy  progresses, 
the  current  record  number  is  displayed  in  parentheses. 


PSECT    3000H 


;This  program  starts  at  x'30001 


©CLOSE: 

@DIRRD: 

@DSP: 

@DSPLY: 

TERROR: 

@EXIT: 

@FEXT: 

@FNAME: 

@FSPEC: 

(3HEXDEC: 

eiNIT: 

@KEYIN: 
@LOC: 

@OPEN: 
@READ: 
@REMOV: 
@V£R: 


First 
This  : 

EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


declare  the  equates  for  the  SVCs  we  intend  to  use. 
s  not  mandatory,  but  it  makes  the  program  easier  to  follow. 


60  ;Close  a  file  or  device 

87  ;Read  a  directory  record 

2  ;Display  character  at  cursor 

10  ;Display  a  message 

26  ;Display  an  error  message 

22  ;Exit  and  return  to  TRSDOS  or  the  caller 

79  ;Add  a  default  file  extension 

80  ;Fetch  a  filespec  from  the  directory 
78  ;Verify  and  load  a  filespec  into  the  FCB 
97  ;Convert  a  binary  value  to  decimal  ASCII 

58  ;Open  an  existing  file  or  create  a  new  file 

9  ; Accept  a  line  of  text  from  the  *KI  device 

63  ;Return  the  current  logical  record  number 

59  ;Open  an  existing  file 
67  ;Read  a  record  from  an  open  file 
57  ;Delete  a  file  from  disk 
73  ;Write  a  record  to  disk.   Does  the  same  thing 

;as  @WRITE  (Svc  75),  but  it  also  makes  sure 
;the  written  data  is  readable. 

First,  prompt  for  the  source  filespec  using  the  @DSPLY  svc. 


LD 
LD 
RST 


HL,MESG1 

A,@DSPLY 
28H 


;Get  the  first  message 
;Display  a  line  on  the  screen 
;Call  the  @DSPLY  svc 


Now,  read  the  filename  from  the  keyboard  using  the  @KEYIN  svc. 

;Put  the  name  of  the  1st  file  here 

;Allow  up  to  24  characters 

;A  zero  is  required  by  the  svc 

;Get  a  filename  from  the  user 

;Call  the  @KEYIN  svc 

;The  user  pressed  <Break> 

;An  Error  occurred 

;Get  the  number  of  characters 

;See  if  that  value  was  zero 

; Nothing  was  entered,  ask  again 

The  user  has  typed  something,  so  it  must  be  checked  for  validity 
using  the  @FSPEC  svc. 


LD 

HL,FILE1 

LD 

B,24 

LD 

C,0 

LD 

A,@KEYIN 

RST 

28H 

JP 

CQUIT 

JP 

NZ,ERR 

LD 

A,B 

OR 

A 

JR 

Z, BEGIN 

LD 
LD 


RST 
JR 


HL,FILE1 
DE,FCB1 


28H 
Z,ASK2 


;Point  at  the  text  the  user  entered 

;Point  at  the  File  Control  Block 

;that  is  to  be  used  for  the  source  file. 

;The  @FSPEC  svc  will  make  sure  the  filename 

;that  is  in  buffer  named  "filel"  is  valid, 

;If  it  is,  it  is  copied  into  the  File 

;Control  Block  (FCB)  to  be  used  by  the  @OPEN 

;or  @INIT  svc  later  on, 

;Call  the  ©FSPEC  svc 

;The  name  for  file  1  is  ok,  so  skip  this 


At  this  point  the  filename  specified  for  file  1  has  been  found 
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00011 
00012 
73 
74 
75 
00016 
00011 


00019 


31 
32 
00083 
00084 
00085 
00086 
00087 


00091 
00092 
00093 
00094 
00095 
00096 
00097 
00098 
00099 
00100 
00101 
00102 
00103 
00104 
00105 
00106 
00107 


00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 
00124 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
00132 
0013  3 
00134 
00135 


LD 

HL,BADFIL 

LD 

A,@DSPLY 

RST 

28H 

JR 

BEGIN 

to  be  in  an  invalid  format.   The  following  code  will  print  the 
error  message. 

;Point  at  the  bad  filename  message 

;Display  it 

;Call  the  @DSPLY  svc 

;Start  over 

At  this  point,  the  source  filename  appears  to  be  valid. 

The  code  below  asks  for  the  second  filename  and  checks  it  for 

validity  also. 

;Prompt  for  the  target  filename 

;Print  that  on  the  screen 

;Call  the  @DSPLY  svc 

;Put  the  name  of  the  2nd  file  here 

;Allow  up  to  24  characters 

;A  zero  is  required  by  the  svc 

;Get  a  filename  from  the  user 

;Call  the  @KEYIN  svc 

;The  user  pressed  <Break> 

;An  Error  occurred 

;Get  the  number  of  characters 
;See  if  that  value  was  zero. 
^Nothing  was  entered,  ask  again 

The  user  has  typed  something,  so  it  must  be  checked  for  validity 

using  the  @FSPEC  svc. 

; Point  at  the  text  the  user  entered 

;Point  at  the  File  Control  Block 

; Check  the  name  for  validity 

;Call  the  @FSPEC  svc 

;The  name  for  file  2  is  ok,  so  skip  this 

The  name  for  file  2  is  invalid  so  print  an  error  message 


LD 

HL,MESG2 

LD 

A,@DSPLY 

RST 

28H 

LD 

HL,FILE2 

LD 

B,24 

LD 

C,0 

LD 

A,@KEYIN 

RST 

28H 

JP 

CQUIT 

JP 

NZ,ERR 

LD 

A,B 

OR 

A 

JR 

Z,ASK2 

LD 

HL,FILE2 

LD 

DE,FCB2 

LD 

A,@FSPEC 

RST 

28H 

JR 

Z,F20K 

LD  HL,BADFIL 

LD  A,@DSPI.Y 

RST  28H 

JR  BEGIN 


;Point  at  the  bad  filename  message 

;Display  it 

;Call  the  @DSPLV  svc 

; Start;  over 


Now  we  will  attempt  to  add  an  extension  to  the  target  file 

if  the  user  did  not  specify  one.   We  use  the  extension  that 

was  specified  on  the  source  file.   If  it  does 

not  have  one,  then  we  will  not  try  to  add  one  to  the  target  file. 

;Point  at  the  source  filename 

;We  start  with  the  second  character  since 

;the  filename  must  be  at  least  one  character 

;Get  a  character  from  the  filespec 

;Is  the  character  the  extension  prefix? 

;Yes,  this  will  be  our  default  extension 

;Have  we  reached  the  end  of  the  filespec? 

;Yes,  there  is  no  extension  so  don't  add  one 

;Test  both  terminators 

;Advance  the  pointer  to  the  next  character 
;Keep  looking 

;Advance  pointer  to  first  byte  of  extension 
;Point  at  FCB  for  the  target  file  (file  2) 
;Add  an  extension  if  one  is  not  present 
;Call  the  @FEXT  svc 


LD 

HL,FCB1+1 

LD 

A, (HL) 

CP 

'/' 

JR 

Z,EXTN 

CP 

0DH 

JR 

Z,NOEXT 

CP 

03H 

JR 

Z,NOEXT 

INC 

HL 

JR 

FDIV 

INC 

HL 

LD 

DE,FCB2 

LD 

A,@FEXT 

RST 

28H 

Now  we  have  two  filenames. 

to  make  sure  it  exists. 


First  we  will  open  the  source  file 
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00136 
#0137 
00138 
00139 
00140 
00141 
00142 
00143 
0014  4 
00145 
00146 
00147 
00148 
00149 
00150 
00151 
00152 
00153 
00154 
00155 
00156 
00157 
00158 
00159 
00160 
00161 
00162 
00163 
00164 
00165 
00166 
00167 
00168 
00169 
00170 
00171 
00172 

0017  3 
00174 
00175 
00176 
00177 
00178 
00179 
00180 
00181 
00182 

0018  3 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00191 
00192 
00193 
00194 
00195 
00196 
00197 
00198 
00199 
00200 
00201 
00202 
00203 


NOB XT :   LD 

LD 


LD 


LD 
RST 
JR 
CP 

JP 


DE, PCB1 
HL,BUFl 


B,0 

A,@OPEN 
28H 
Z,  SIZ 

42 
NZ,ERR 


;Point  at  the  Fi 
;Point  at  the  sy 
;is  used  by  the 
;is  written  to  d 
;is  read  from  di 
;Lengfch  of  the  f 
;256,  then  this 
;Use  LRL  256  for 
;what  to  use  yet 
;Open  the  file 
;Call  the  @OPEN 
;The  file  opened 
;Was  the  error  a 
;No,  perhaps  the 


ie  Control  Block  for  file! 
stem  buffer.   This  buffer 
system  to  block  data  that 
isk  and  de-block  data  that 
sk  when  the  Logical  Record 
ile  is  not  256.   If  it  is 
buffer  is  not  used, 
now  since  we  don't  know 


SVC 

and  is  LRL  256. 
LRL  Open  Fault? 
file  does  not  exist. 


At  this  point,  the  file  is  open  and  we  can  now  examine  the 
directory  to  find  out  what  LRL  it  was  created  with  so  we  can 
use  that  value  to  make  the  copy. 


LD 


A, (FCB1+6) 


LD 

A,  (FCB1  +  7) 

LD 

B,A 

PUSH 

BC 

LD 

A,@CLOSE 

RST 

28  H 

POP 

BC 

LD 

A,@DIRRD 

RST 

28H 

LD 

IX, HL 

LD 

A, (IX+4) 

(LRL) ,A 


;Get  the  byte  in  the  FCB  which  contains 

;the  drive  number  the  file  is  on 

;Erase  all  other  information  in  that  byte 

;Save  that  value  here 

;This  reads  the  Directory  Entry  Code  (DEC) 

;out  of  the  FCB  so  we  can  use  it 

;Store  the  DEC  here 

;Save  that  value  for  now 

;We  can  close  the  source  file  for  now 

;Call  the  @CLOSE  svc 

;Get  the  DEC  value  back  off:  the  stack 
;Read  the  directory  record  for  that  file 
;Call  the  8DIRRD  svc 

;Put  the  pointer  to  the  directory  record 
;here  and  read  the  DIR+4  entry  which 
;contains  the  LRL  of  the  source  file. 
;Save  that  value 


Before  we  go  any  further,  we  should  check  to  see  if  the  target  file 
already  exists. 


LD 
LD 
LD 
LDIR 

LD 

LD 

LD 

LD 

RST 

JR 

CP 

JR 

EXISTS:  LD 

LD 
RST 

WAIT :    LD 
RST 
JR 

CP 
JR 


DE,COPY 

HL,FCB2 
BC,32 


DE,FCB2 

HL,BUF2 

B,0 

A,@OP£N 

28H 

2, EXISTS 

42 

NZ,NOFILE 

HL,FEXST 

A,@DSPLY 
28H 

A,@KBD 
28H 

NZ,WAIT 

1  y. 

Z,KILLIT 


;First,  make  a  copy  of  the  FCB 
;in  case  we  have  to  delete  a  file 
;Move  the  entire  block 


;Point  at  the  target  File  Control  Block 

;Use  this  as  the  buffer  for  now 

;Use  LRL  256  for  now 

;Open  it  and  see  if  it  is  there 

;Call  the  @OPEN  svc 

;The  file  already  exists,  better  ask 

;Was  the  error  a  LRL  mismatch? 

;No,  so  the  file  does  not  exist. 

;Point  at  a  prompt  asking  if  it  is  ok 
;to  erase  the  file  that  already  exists 
; Print  that  message 
;Call  the  @DSPLY  svc 

;Wait  for  the  user  to  type  Y  or  N 

;Call  the  @KBD  svc 

;Loop  until  something  is  typed 

;Was  a  'Y'  typed? 
;Then  kill  the  file 
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00204 
00205 
00206 
00207 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00218 
00219 
00220 
00221 
00222 
00223 
00224 
00225 
00226 
00227 
00228 
00229 
00230 
00231 
00232 
00233 
00234 
00235 
00236 
00237 
00238 
00239 
002  40 
00241 
00242 
00243 
00244 
00245 
002  46 
00247 
00248 
00249 
00250 
00251 
00252 
00253 
00254 
00255 
00256 
00257 
00258 
00259 
00260 
00261 
00262 
00263 
00264 
00265 
00266 
00267 
00268 
00269 
00270 


CP 
JR 
CP 
JR 
CP 
JR 

SHUT:    LD 
LD 
RST 
JP 


Z,KILLIT 

Z,SHUT 
i  n  t 

NZ,WAIT 

DE,FCB2 
A,@CLOSE 
28H 
QUIT 


;Check  for  lowercase  too 

;Do  they  want  to  leave  the  file  alone? 

;No,  just  close  the  file  and  quit 

;Was  it  a  lowercase  'N ' ? 

;No,  loop  until  we  see  something  we  like 

;Close  the  target  file 

;Call  the  @CLOSE  svc 
;Exit  to  TRSDOS 


At  this  point,  we  have  been  given  the  OK  to  delete  the  file 
that  has  the  same  name  as  the  target  file. 


KILLIT:  LD 
LD 
RST 

LD 
LD 
RST 

JP 


C,0DH 

A,@DSP 

28H 

DE,FCB2 

A,@REMOV 

28H 

NZ,ERR 


;Pirst  move  display  to  a  new  line 
;Display  an  <Enter> 
;Call  the  @DSP  svc 

;Point  at  the  target  file's  FCB 

;Delete  the  file  from  disk 

?Call  the  @REMOV  svc.   (This  is  the  same 

;as  the  @KILL  call  on  other  TRSDOS  systems.) 

;An  error  occurred,  print  it  and  quit 

;Note  that  after  a  @REMOV  succeeds, 

;the  filespec  is  removed  from  the  FCB. 

;So  we  have  to  keep  a  copy  around 

;in  case  we  need  it . 

;Get  the  copy 

;Put  it  here 

; Move  up  to  32  bytes 

;Copy  the  FCB  so  we  can  continue 

Now  we  know  what  Logical  Record  Length  <LRL)  to  use  in  the 
copy,  so  we  can  open  the  source  file  and  create  the  target  file 
with  the  correct  record  lengths . 


LD 

HL,COPY 

LD 

DE,FCB2 

LD 

BC,32 

LDIR 

NOFILE:  LD 
LD 
RST 
LD 
LD 
RST 

LD 

LD 

LD 

LD 

LD 

RST 

JP 

LD 
LD 
RST 

LD 
LD 
CP 
JR 
LD 
JR 
LRL256:  LD 


LRLCOM:  LD 
LD 


HL,FCB1 

A,@DSPLY 

28H 

HL, SPACES 

A,@DSPLY 

28H 

DE,FCB1 

HL,BUF1 

A, (LRL) 

B,A 

A,@OPEN 

28H 

NZ,ERR 

HL, ARROW 
A,@DSPLY 
28H 

DE,FCB2 

A,  (LRL) 

0 

Z,LRL256 

HL,BUF2 

LRLCOM 

HL,BUF1 


B,A 
A,@INIT 


;Point  at  the  filename  in  the  FCB 

;Print  that  name 

;Call  the  @DSPLY  svc 

;Point  at  some  spaces 

;Space  over  a  few  places  on  the  screen 

;Call  the  @DSPLY  svc 

;Point  at  File  Control  Block  for  source  file 

;Put  data  in  this 

;Read  the  Logical  Record  Length 

;Load  the  Logical  Record  Length 

;Open  the  source  file 

;Call  the  @OPEN  svc 

;Open  failed 

;Point  at  the  arrow  text 

;Print  that  to  show  the  direction  of  copy 

;Call  the  @DSPLY  svc 

;Point  at  File  Control  Block  for  target  file 

;Get  the  Logical  Record  Length 

;Is  the  LRL  256? 

;Then  we  do  something  special 

;Use  a  different  buffer  for  target  file 

;Jump  to  common  code 

;We  use  the  same  buffer  when  the  LRL  is  256 

;since  there  is  no  need  to  block  and  de-block 

;the  data. 

;Load  the  Logical  Record  Length 

;Open  the  target  file 
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00271 
00272 
00273 
00274 
00275 
00276 
00277 
00278 
00279 
00280 
00281 
00282 
00283 
00284 
00285 
00286 
00287 
00288 
00289 
00290 
00291 
00292 
00293 
00294 
00295 
00296 
00297 
002  98 
00299 
00300 
00301 
00302 
00303 
00304 
00305 
00306 
00307 
00308 
00309 
00310 
00311 
00312 
00313 
00314 
00315 
00316 
00317 
00318 
00319 
00320 
00321 
00322 
00323 
00324 
00325 
00326 
00327 
00328 
00329 
00330 
00331 
00332 
00333 
00334 
00335 
00336 
00337 
00338 


RST 

■JR 


28H 

NJ7  .  RPR 


DE,FILE2 


LD 

A, (PCB2+7) 

LD 

B,A 

LD 

A, (FCB2+6) 

AND 

7 

LD 

C,A 

LD 

A , @ FNAME 

RST 

28H 

LD 

HL,FIL£2 

LD 

A,@DSPLY 

RST 

28H 

LD 

HL, SPACES 

LD 

A,@DSPLY 

RST 

28H 

;Call  the  §INIT  svc 

.;Init  failed 

;We  are  going  to  get  the  filename  for 

;the  target  file  from  the  system 

; instead  of  using  the  one  we  have.   The 

jreason  for  this  is  that  the  system  will 

;append  the  drive  number  to  the  filename 

;if  one  was  not  specified. 

;Get  the  Directory  Entry  Code  for  the  file 

;Put  the  DEC  here 

;Get  the  Drive  Number  from  the  FCB 

;Lose  all  data  except  the  drive  number 

;Store  drive  number  here 

;Have  the  system  produce  a  f ilespec 

;Call  the  @FNAME  svc 

;Now  point  at  the  filespec  produced 

;and  print  it  out 

;Call  the  @DSPLY  svc 

; Space  over  a  few  more  places 

;so  the  display  will  look  neat 
;Call  the  @DSPLY  svc 

At  this  point,  both  files  are  open  and  ready  to  be  used. 
The  following  code  reads  a  record  from  the  source  file 
and  writes  it  to  the  target  file.   This  is  done  until  an 
end  of  file  is  encountered. 

;Point  at  file  1  (source  file) 

;Put  data  here 

;Read  a  record  from  the  source  file 

fCall  the  @READ  svc 

; Jump  if  the  eof  has  been  reached 

;Point  at  file  2  (target  file) 

Before  writing  the  record ,  display  the  record  number,  which 
is  obtained  from  the  @LOC  svc. 

;Get  the  current  record  number 
;Call  the  @LOC  svc 

;Get  the  current  record  number 

;and  put  it  in  register  HL 

;Store  the  result  here. 

;Convert  binary  to  ASCII  in  decimal  format 

;Call  the  @HEXDEC  svc 

;Get  a  blank 

;Look  at  the  front  of  the  buffer 

;Is  the  character  a  blank? 

;A  number  has  been  found 

; Advance  the  pointer 

;Loop  until  we  find  a  number 

;Back  up  one  position 

;Get  the  character  we  want  to  insert 

;Store  that  character. 

;The  buffer  now  contains 

;<none  or  more  spaces>  ( record  number) 

;<7  left-cursor  characters><etx> 

; Point  at  this  text 

;and  display  it  on  the  screen 

;Call  the  @DSPLY  svc 

Now  write  the  record  to  the  target  file. 

LD      DE,FCB2         ;Point  at  the  FCB  for  the  target  file 


LD 

DE,FCB1 

LD 

HL, BUFFER 

LD 

A,@READ 

RST 

28H 

JR 

NZ,EOF 

LD 

DE,FCB2 

LD 

A,@LOC 

RST 

28H 

PUSH 

BC 

POP 

HL 

LD 

DE,L0CMSG+1 

LD 

A,@HEXDEC 

RST 

28H 

LD 

A,  '  ' 

LD 

HL,LOCMSG 

CP 

(HL) 

JR 

NZ,NUMBR 

INC 

HL 

JR 

EDIT 

DEC 

HL 

LD 

A,  f  (  * 

LD 

(HL)  ,A 

LD 

HL,LOCMSG 

LD 

A,@DSPLY 

RST 

28H 
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Sample  Program  C,  continued 


00339 

#0340 

00341 

00342 

00343 

00344 

00345 

003  46 

00347 

00348 

00349 

00350 

00351 

00352 

00353 

00354 

00355 

00356 

00357 

00358 

00359 

00360 

00361 

00362 

00363 

00364 

00365 

00366 

00367 

00368 

00369 

00370 

00371 

00372 

0037  3 

00374 

00375 

00376 

00377 

00378 

00379 

00380 

00381 

00382 

00383 

00384 

00385 

00386 

00387 

00388 

00389 

00390 

00391 

00392 

00393 

00394 

00395 

00396 

00397 

00398 

00399 


00401 
00402 
00403 
00404 
00405 


LD 
LD 


RST 
JR 


QUIT: 


SPACES: 

ARROW: 

OK: 

MESG1: 
MESG2: 
FEXST: 


HL, BUFFER 
A,©VER 


28H 

NZ,ERR 


; Point  at  the  data  read  from  file  1 

;Write  a  record  to  the  target  file 

;The  ©VER  does  the  same  thing  as  the 

; ©WRITE  svc,  only  it  also  checks  the 

;data  to  make  sure  it  is  readable . 

;Call  the  ©VER  svc 

;An  error  occurred  on  write;  possibly 

;the  disk  is  full. 

;Loop  until  an  error  occurs. 


This  code  checks  the  error  to  make  sure  it  was  an  end  of  file 
condition  and,  if  so,  closes  the  source  &  target  files. 

CP  28  ;Was  it  an  end  of  file  encountered? 

JR  Z,EOFYES  ;Yes,  close  the  file 

CP  29  ;Was  it  "Record  number  out  of  range"? 

jr  NZ,ERR  ;No,  must  be  some  other  error 

It  is  possible  to  get  Error  29  if  the  file  being  copied  has 
an  EOF  that  is  not  a  multiple  of  the  file's  LRL 


LD 
LD 
RST 
JR 

LD 
LD 
RST 
JR 

LD 
LD 
RST 

LD 

RST 


DE,FCB1 
A, ©CLOSE 
28H 
NZ,ERR 

DE,FCB2 
A,  ©CLOSE 
28H 
NZ,ERR 

HL,OK 

A,©DSPLY 

28H 

A,  ©  EX  IT 
28H 


;Point  at  file  1  (source  file) 

;Close  the  file 

;Call  the  ©CLOSE  svc 

;An  error  occurred*  abort 

;Point  at  file  2  (target  file) 

;Close  it  also 

;Call  the  ©CLOSE  svc 

;An  error  occurred,  abort 

;Print  a  message  saying  the  copy  is  done 

;Call  the  ©DSPLY  svc 

;Exit  to  TRSDOS  or  the  calling  program 
;Call  the  ©EXIT  svc 


The  ©EXIT  svc  does  not  return. 


040H 


;Turn  on  bit  6,  which 

;will  cause  the  ©ERROR  svc  to  print 

;the  short  error  message.  Bit  7 

;is  not  set,  which  instructs  the  ©ERROR 

;to  abort  this  program  and  return  to 

; TRSDOS  Ready. 

;Put  error  code  &  flags  in  register  C 

;Call  the  system  error  displayer 

;Call  the  ©ERROR  svc 

Because  bit  7  is  not  set,  the  ©ERROR  svc  will  not  return. 

Storage  Declaration 

;ASCII  Space  char. for  display  formatting 
;Arrow  for  display  shows  data  direction 


LD 

C,A 

LD 

A, ©ERROR 

RST 

28H 

DEFM 
DEFB 
DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 
DEFM 
DEFB 


3 

»^>   » 

3 

10%25 

•[Ok]' 

0DH 


;Advance  cursor  10  spaces  without  erasing 
;Used  to  indicate  the  Copy  is  complete 
^Terminated  with  an  <Enter> 


'Copy  Filespec  >' 

3 

•To  Filespec  > ' 

3 

'Destination  File  Already  Exists  -  Ok  to  Delete  it  <Y/N)  ?* 


Software  173 


Sample  Program  C,  continued 


00406 
00407 


00409 
00410 
00411 
00412 
00413 
00414 
00415 
00416 
00417 
00418 
00419 
00420 
00421 
00422 
00423 
00424 


BADFIL: 
LOCMSG: 


FILE1: 

FILE2: 

FCB1: 

FCB2: 

COPY: 

LRL: 

BUF1: 
BUF2: 
BUFFER: 


DEFM 

DEFB 
DEFM 

DEFB 
DEFB 

DEFS 
DEFS 
DEFS 
DEFS 
DEFS 
DEFB 

DEFS 
DEFS 
DEFS 


•Invalid  Filename 

0DH 

*  12345)* 


32 
32 
32 
32 
32 
0 

256 
256 
256 


Try  Again' 

;This  will  be  used  in  building  the  LOC 
;Display  will  appear  as  (d)  to  (ddddd). 
;Backspace  without  erasing 
;Etx,  used  to  get  the  §DSPLY  svc  to  stop 

;User  Text  Originally  placed  here 

;Target  Filename  goes  here 

;32  bytes  for  the  File  Control  Block 

;32  bytes  for  the  File  Control  Block 

?An  extra  copy  of  the  target  FCB  goes  here 

;The  Logical  Record  Length  of  the  source 

;file  will  be  stored  here 

;System  buffer  for  File  1 

;System  buffer  for  File  2 

;Data  buffer  for  both  files 

;"begin"  is  the  starting  address 
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Sample  Program  D 


Ln  # 


Source  Line 


00003 


00007 
00009 
00010 


12 
L3 
00014 
15 
16 
L7 
00018 
00019 
00020 
00021 
00022 
00023 
00024 
00025 
00026 
00027 


00029 
00030 
00031 
00032 
00033 
0003  4 
00035 


00037 


00039 


00041 
00042 
00043 
00044 
00045 


00049 
00050 
00051 
00052 
0005  3 
0005  4 
00055 
00056 
00057 
00058 
0005  9 
00060 
00061 
00062 
63 


00065 
66 

67 


This  program  will  read  a  sector  from  the  disk  in  Drive  0 
and  will  write  it  to  a  disk  in  Drive  1.   The  disk  in  Drive  1 
must  be  formatted,  but  should  not  have  anything  important  on 
it.   This  program  makes  an  assumption  that  the  directory  is 
located  on  cylinder  20  {x'14'K 


PSECT    3000H 


;This  program  begins  at  x,3000". 


Define  the  equates  for  the  SVCs  that  will  be  used. 


@ ABORT:  EQU 

@CKDRV:  EQU 
@DCSTAT : EQU 
@ ERROR:  EQU 
8 EX IT: 

@RDSEC: 
@RDSSC: 
@WRSEC: 
0WRSSC : 


SYSSEC: 
USRSEC: 


EQU 
EQU 
EQU 
EQU 
EQU 


21 
33 
40 
26 
22 
49 
85 
53 
54 


Other  Equates 


EQU 
EQU 


14 
0000H 


; Abort  and  return  to  TRSDOS 

;Test  to  see  if  a  drive  is  ready 

;Verify  that  a  drive  is  defined  in  the  DCT 

;Display  an  error  message 

;Return  to  TRSDOS  or  the  calling  program 

;Read  a  sector 

;Read  a  system  sector 

; Write  a  sector 

;Write  a  system  sector 


;The  system  sector  is  Cylinder  20,  Sector 
;The  regular  sector  is  Cylinder  0,  Sector 


First,  test  the  target  drive  and  make  sure  it  is  defined. 

;Select  Drive  1 

;Ask  if  the  drive  is  listed  in  the  DCT 

;Call  the  @DCSTAT  svc 

;If  NZ,  then  the  drive  is  not  defined 

;and  we  will  abort  execution . 


LD 

C,l 

LD 

A,@DCSTAT 

RST 

28H 

JR 

NZ, ERROR 

Now,  test  and  make  sure  the  target  drive  contains 
disk  and  is  write-enabled. 


formatted 


LD       C,l 

LD       A,@CKDRV 


RST      28H 

LD       A,  8 


JR 
LD 


NZ, ERROR 
A, 15 


C, ERROR 


;Select  Drive  1 

;Test  to  see  if  the  disk  is  formatted 

;and  is  write-enabled.   Note  that  the 

;disk  must  be  formatted  by  TRSDOS  6.x 

;or  by  LDOS  5.1.x  to  be  considered 

; "formatted"  by  this  svc. 

;Call  the  §CKDRV  svc 

;This  will  become  the  error  number  if  the 

;drive  was  not  ready.   This  is  done 

; because  the  @CKDRV  svc  does  not  return  error 

;codes . 

;The  drive  is  not  ready 

;This  will  become  the  error  number  if  the 

;drive  is  ready  and  is  write-protected . 

;As  above,  this  is  done  because  @CKDRV  does 

;not  return  error  messages. 

;The  disk  is  formatted,  but  it  is 

; write-protected.   In  either  case,  abort. 


Now  that  we  know  the  target  drive  is  ready,  read  a  sector 

from  the  source  drive  and  write  it  to  the  target  drive  {Drive  1). 

^Select  Drive  0 

;Read  the  first  sector  on  the  disk, 

;Cylinder  0,  Sector  0. 

;Point  to  a  buffer  which  will  hold  the  sector 

?Read  a  non- system  sector 

;Call  the  @RDSEC  svc 

; If  NZ,  an  error  occurred ,  so  abort 


LD 

DE, USRSEC 

LD 

HL,BUFF 

LD 

A,@RDSEC 

RST 

28H 

JR 

NZ, ERROR 
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Sample  Program  D,  continued 


00068 
0006  9 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
00077 
00078 
00079 


00081 
00082 
00083 
00084 
00085 
00086 
00087 


00089 

00091 
00092 
00093 
00094 
00095 
00096 
00097 


00099 


00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 
00124 
00125 
00126 
00127 


Now,  write  the  sector  to  the  target  drive. 

LD  C,l  ;Select  Drive  1 

LD  DE,USRSEC  ;Write  the  sector  to  Cylinder  0,  Sector  0 

;on  Drive  1 

LD  HL,BUPF  ;Point  to  the  buffer  containing  the  sector 

LD  A,@WRSEC  ;Write  the  sector  to  disk 

RST  28H  ;Call  the  @WRSEC  svc 

JR  NZ, ERROR  ;lf  NZ ,  an  error  occurred,  so  abort 

Mow  we  will  read  a  system  sector  from  Drive  0  and  write  it  on 
drive  1.   The  difference  between  a  system  sector  and  a  non-system 
sector  is  that  the  Data  Address  Marks  (DAM)  are  different.   These 
were  written  to  the  disk  when  it  was  formatted.   TRSDOS  6.x  uses 
these  as  an  extra  check  to  make  sure  that  a  write  of  user  data 
does  not  accidentally  get  placed  over  a  sector  containing  system 
data.   All  of  the  sectors  in  the  directory  cylinder  are  marked 
as  system  sectors. 


LD 
LD 
LD 

RST 
JR 


C0 

DE,SYSSEG 

HL,BUFF 

28H 

NZ, ERROR 


Select  Drive  0 

Read  Cylinder  20,  Sector  0 

Store  the  sector  at  this  address 

Call  the  @RDSSC  svc 

An  error  occurred,  so  abort 


Now  write  the  sector  to  the  target  drive  as  a  system  sector . 
There  is  no  requirement  that  a  sector  must  be  placed  at  the 
same  cylinder  and  sector  location  as  it  was  read  from,  but 
for  simplicity,  we  are  doing  that. 

;Select  Drive  1 

;Write  Cylinder  20,  Sector  0 

; Point  to  the  data  to  be  written 

;Write  a  system  sector 

;Call  the  @WRSSC  svc 

;An  error  occurred,  so  abort 

;Return  to  TRSDOS  or  the  calling  program 
;Call  the  @EXIT  svc 

This  routine  displays  an  error  message  if  anything  goes  wrong. 
Note  that  @CKDRV  does  not  return  an  error  message,  so  @ERROR 
cannot  be  used  for  it  without  some  manipulation. 


LD 

C,l 

LD 

DE,SYSS£C 

LD 

HL,BUFF 

LD 

A,@WRSSC 

RST 

28R 

JR 

NZ, ERROR 

LD 

A,@EXIT 

RST 

28H 

OR 
LD 
LD 


LD 


0C0H 

C,A 

A, TERROR 

28H 

A, @ ABORT 


RST      28 H 
BUFF:    DEFS     256 

END      STAR 


;Set  bit  7 

;Load  error  number  into  register  C 
;This  will  display  the  error  message 
;and  return  to  the  calling  program 
;Call  the  TERROR  svc 

;Now,  force  an  abort.  This  will  return 
;to  TRSDOS  Ready  and  will  abort  any 
;JCL  file  that  is  currently  executing 
;Call  the  ©ABORT  svc 

;256-byte  buffer  to  store  the  sector  that 
;is  read  and  then  written 
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Sample  Program  E 


Source  Line 


02 
03 
»4 
00006 


00009 


11 
00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 


00021 
00022 
00023 
00024 
00025 
00026 
27 


29 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 

0004  4 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 

0005  3 
0005  4 
00055 
00056 
00057 
00058 
0005  9 


This  program  displays  the  filenames  of:  the  disk  in 
Drive  0  three  different  ways. 


PSECT    3000H 


6CMNDI: 
@CMNDR: 
@DODIR: 


DIR0: 


^Program  begins  at  x'3000' 


First,  declare  the  equates  for  the  SVCs  we  intend  to  use. 

This  is  not  mandatory,  but  it  makes  the  program  easier  to  follow. 


EQU     24 
EQU      25 

EQU      34 


; Execute  a  TRSDOS  command  and  return 

;to  TRSDOS  Ready 

; Execute  a  TRSDOS  command  and  return 

;to  the  calling  program 

jfDisplay  visible  filenames  on  the 

^specified  disk  drive 


First,  pass  a  "DIR  :0"  command  to  the  system.   TRSDOS  will 
execute  this  command  and  then  return  to  this  program. 

LD      HL,DIR0         ;Point  at  command  we  want  to  execute 

LD      A,@CMNDR        ; Execute  the  specified  command  and  return 

RST      28H  ;Call  the  @CMNDR  svc 

You  may  have  noticed  that  the  DIR  displayed  the  files,  but  that 
they  were  not  sorted  alphabetically.   This  is  because  the  DIR 
command  will  not  use  memory  above  x'3000'  when  it  is  invoked  with 
a  @CMNDR  svc.   This  prevents  the  DIR  command  from  performing  a 
sort  of  the  filenames . 


Now  do  a  directory  command  using  the  @DODIR  svc. 


LD 
LD 


B,0 

C,0 
A,@DODIR 


28H 


;Use  Function  0  which  displays  all 
;visible  files  in  the  directory. 
;Put  source  drive  number  in  register 
;The  filenames  will  be  read  from  the 
;directory  and  displayed  in  the 
;order  they  appear  in  the  directory. 
;Call  the  @DODIR  svc 


Now  pass  a  "DIR  :0"  command  to  the  system.   This  time 

the  command  will  be  executed  and  then  TRSDOS  will  not  return 

to  this  program,  but  will  return  to  TRSDOS  Ready. 

LD      HL,DIR0         ; Point  at  the  command  we  want  performed 
LD      A,@CMNDI        ;and  execute  it,  but  don't  return  to 

;this  program. 
RST      28H  ;Call  the  @CMNDI  svc 

;This  svc  returns  to  TRSDOS  Ready. 

Note  that  when  the  library  command  DIR  is  performed  this  time, 
the  display  of  files  is  sorted.   This  is  because  DIR  determines 
that  it  was  invoked  with  a  @CMNDI  svc,  and  it  will  not  return 
to  the  calling  program.   Therefore,  DIR  is  free  to  use  the 
memory  above  x*3000'  to  perform  the  sort  of  the  filenames  in 
the  directory. 


Constants 
DEFM     'DIR  :0' 
DEFB     0DH 
END      START 


;This  command  is  passed  to  TRSDOS 

;via  the  @CMNDR  and  @CMNDI  SVCs. 

? It  must  be  terminated  with  an  <ENTER>. 
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Sample  Program  F 


r,n  # 


Source  Line 


00002 
00003 
00004 
00005 
00006 


00008 


00011 
00012 
00013 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
0002  3 
00024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 


41 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
00053 
0005  4 
00055 
00056 
00057 
00058 
0005  9 


00061 


0006  3 
54 
55 
00066 
00067 


This  program  adds  to  the  system  task  scheduler  a  task 

which  displays  the  date  and  a  running  count  of  the  number 

of  times  the  task  has  been  executed. 

For  simplicity,  the  program  tries  to  use  task  slot  0. 

If  it  is  already  in  use,  it  assumes  that  the  task  using  that 

slot  is  this  program,  and  it  kills  the  task.  It  then  tries  to 

recover  the  memory  used  by  the  task  in  high  memory. 

If  the  task  slot  is  not  in  use,  the  task  is  placed  in  high  memory, 

and  the  address  of  the  task  is  passed  to  the  task  scheduler. 

The  first  time  you  run  this  program  it  adds  the  task,  and  the 

next  time  you  run  this  program,  it  removes  the  task. 


PSECT    3000H 


;This  program  starts  at  x'3000' 


First,  declare  the  equates  for  the  SVCs  we  intend  to  use. 

This  is  not  mandatory,  but  it  makes  the  program  easier  to  follow. 


@ADTSK:  EQU 

@CKTSK:  EQU 

@DATE:  EQU 

@DSPLY:  EQU 

BEXIT:  EQU 

@GTMOD:  EQU 
@HEXDEC:EQU 

@HIGH$ :  EQU 

@RMTSK:  EQU 

@VDCTL:  EQU 

@WHERE:  EQU 


29  ;Add  a  task  entry  to  the  scheduler 

28  ;Check  to  see  if  a  task  slot  is  in  use 

18  ;Return  the  date  in  ASCII  format 

10  ;Display  a  message 

It  ; Return  to  TKSUOS  Ready  or  the  caller 

83  ; Locate  a  memory  module 

97  ;Convert  a  binary  value  to  decimal  ASCII 

100  ;Read  or  modify  HIGH?  or  LOW? 

30  ;Remove  a  task  entry  from  the  scheduler 
15  ; Perform  video  operations 

7  ;Find  out  where  the  program  counter  is 

;when  this  SVC  is  executed.   This  is 
;useful  in  relocatable  code  that  must 
;make  absolute  address  references  to 
;call  subroutines  or  modify  data. 


Below  we  will  define  a  macro  to  simulate  a  call  relative 
instruction.   Since  the  task  must  be  able  to  run  no  matter 
where  it  is  placed,  it  must  use  relative  jumps  and  calls. 
The  Z80  instruction  set  has  a  jump  relative  ( JR) ,  but  does 
not  have  a  call  relative  instruction.   This  can  be  simulated 
using  the  ©WHERE  SVC,  which  returns  the  address  of  the  caller 
in  a  register.   This  address  can  be  adjusted  and  placed  on 
the  stack  as  a  return  address.  Then  a  jump  relative  can  be  used 
to  reach  the  subroutine. 


CALLR:   MACRO 
PUSH 

PUSH 

PUSH 

LD 

RST 

LD 


ADD 

POP 

POP 

EX 

JR 

ENDM 


#1 

HL 

BC 

AF 

A,@WHERE 

28H 

BC, 3+1+1+1+1+2 


HL,BC 

AF 
BC 
(SP) ,HL 

#1 


;#1  will  be  the  address  you  want  to  call 

;Save  the  registers  we  damage 

;Save  it 

;Save  it 

;Get  our  current  address 

;Call  the  8WHERE  svc 

;Get  the  lengths  of  the  instructions  after 

;the  SVC.   This  will  allow  the  subroutine 

;to  return  to  the  correct  address. 

;Add  that  offset  to  where  we  are 

;Put  stack  back 

;Restore  registers 

;Put  return  address  on  stack  and  restore  HL 

;Jump  to  the  subroutine 

;End  of  the  macro 


This  is  the  main  program.   It  loads  at  x'3000'.   It  decides 
if  it  needs  to  add  or  remove  the  task  in  the  scheduler  tables. 
If  it  adds  the  task,  it  moves  a  copy  to  the  top  of  memory  and 
protects  it,  and  adds  a  task  entry  to  the  scheduler. 
If  it  is  removing  a  task,  it  kills  the  entry  in  the  scheduler 
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Sample  Program  F,  continued 


00069 


00011 
00072 
00013 
0001 A 
00015 
0001 6 
00011 
00078 
00019 


31 

63 
34 
00085 
00086 
00087 
00088 
00089 
00090 
00091 
00092 
00093 
00094 
00095 
00096 
00091 
00098 
00099 


00101 
00102 
00103 
00104 
00105 
00106 
00107 
00108 
00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 
00124 
00125 
00126 
00127 
00128 
0012  9 
00130 
00131 
00132 
00133 
00134 
00135 


tables,  and  then  attempts  to  recover  the  memory  used  by  the  task. 

LD  C,0  ;First,  we  will  test  slot  0 

LD  A,@CKTSK  ; to  see  if  anyone  is  using  it 

RST  28H  ;Call  the  @CKTSK  svc 

JR  NZ,KILLIT  ;There  is  a  task  using  slot  0,  kill  it 

At  this  point,  we  want  to  add  a  task  to  high  memory. 
First  we  find  the  value  for  HIGH?  and  put  a  copy  of  the 
task  there.   Then  we  protect  the  task  by  moving  HIGHS  below 
the  new  task. 


LD 
LD 

LD 
RST 

LD 


LD 
LD 
LD 


LD 
LD 
LD 
RST 


HL,0 

B,H 

A,@HIGH$ 

28H 

(ENDADD) ,HL 


;First,  get  the  value  of  HIGH$ 
;Read  HIGH? 

;Call  the  @HIGH$  svc 

;Save  this  value  as  the  last  address 
;that  the  task  will  be  stored  in  once  it 
;is  moved  to  high  memory 


DE,HL  ;Put  that  value  here 

HL,M0DEND-1     ;Point  at  the  end  of  the  module 
BC, MOD END -MODULE? Move  the  module  from  where  it  is 

;right  now  to  a  position  below  HIGH$ 

;Do  the  copy 


HL,DE 
B,0 

A,@HIGH$ 
28H 


;Now  protect  the  module  using  HIGH? 
jUpdate  HIGH$ 

;Call  the  §HIGH$  svc 


Now  we  need  to  load  the  TCB  entry  in  the  module  with  the  address 
of  the  first  instruction  to  be  executed. 


LD 

LD 

ADD 

LD 

LD 


IX, HL  ;ix  now  points  at  memory  header 

BC,ENTRY-M0DULE+1      ;Get  the  offset  into  the  module 

;of  the  first  instruction 
HL'BC  ;HL  now  contains  the  actual  starting  address 

(IX+U+MODTCB-MODULE)),L       ;Store  LSB  of  the  address 
(IX+1+(1+M0DTCB-M0DULE)),H     ;Store  MSB  of  the  address 


Now  the  task  is  ready  to  run. 
scheduler  table. 


We  now  add  the  entry  to  the  task 


BC,M0DTCB-M0DULE+1 


PUSH 

IX 

POP 

HL 

ADD 

HL,BC 

LD 

DE,HL 

LD 

C,0 

LD 

A,@ADTSK 

RST 

28H 

The  main   program 

LD 

HL, ADDED 

LD 

A,@DSPLY 

RST 

28H 

LD 

A,@EXIT 

RST 

28H 

;Get  offset  into  the 

;module  of  the  TCB  word 
;Get  a  copy  of  the  base  address 
;Put  base  address  here 
;Now  HL  points  at  TCB  address 
;Put  that  value  in  DE 
;Add  this  entry  to  task  slot  0 
;Add  this  task,  to  be  run  every  266.67  msec 
;Call  the  @ADTSK  svc 


; Point  at  a  message  saying  what  was  done 
;and  print  it 

;Call  the  @DSPLY  svc 


;Now  exit 

;Call  the  8EXIT  svc 

This  SVC  does  not  return. 

This  part  of  the  code  removes  the  task  from  the  scheduler 
tables  and  then  attempts  to  recover  the  memory  that  was  used 
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Sample  Program  F,  continued 


«0136 

00137 

00138 

00139 

00140 

00141 

00142 

00143 

00144 

00145 

00146 

00147 

00148 

00149 

00150 

00151 

00152 

0015  3 

00154 

00155 

00156 

00157 

00158 

J3#i59 

00160 

00161 

00162 

00163 

00164 

00165 

00166 

00167 

00168 

00169 

00170 

00171 

00172 

00173 

00174 

00175 

00176 

00177 

00178 

00179 

00180 

00181 

00182 

00183 

00184 

00185 

00186 

00187 

00188 

00189 

00190 

00191 

00192 

00193 

00194 

00195 

00196 

00197 

00198 

00199 

00200 

00201 

00202 

00203 


by  the  task  in  high  memory.   If  another  high  memory  module 
was  added  AFTER  this  task  was  added,  then  the  memory  that 
was  used  by  this  task  cannot  be  recovered. 


LD 
LD 
RST 


C,0 

A,@RMTSK 
28H 


;We  want  to  remove  the  task  in  slot  0 
;Call  the  @RMTSK  svc 


At  this  point,  the  task  is  no  longer  called  by  the  operating 
system.   Now  we  want  to  determine  if  we  can 
reclaim  the  memory  it  was  using. 

;Point  at  the  name  of  the  module 

;Look  for  a  module  with  that  name 

;Call  the  @GTMOD  svc 

;If  NZ  is  set,  then  we  killed  some  other 

;task  that  was  using  slot  0.   Oops. 

;In  that  case,  just  stop  and  don't  do  any 

;more  damage. 

;Set  IX  to  point  to  the  module. 

;Read  the  current  value  of  HIGH$ 

;to  see  if  this  is  the  first  program  in 

;high  memory 

;l£  ic  is,  then  w«  can  i  euuvet  Lh<s  spaCc 

;Call  the  @HIGH$  svc 

;Move  HIGH$  up  by  one  byte 

;Take  the  address  of  our  module 

;and  store  it  here 

;Compare  these 

;Are  they  the  same? 

;No,  the  high  memory  module  can't  be  removed 

At  this  point,  we  know  it  is  ok  to  reclaim  the  memory  used  by  the 
high  memory  task. 

;Read  the  end  of  module  value  out  of  the 
; header  information 
;Update  the  HIGH$  value 


LD 

DE,MODNAM 

LD 

A,@GTMOD 

RST 

28H 

JR 

NZ,CANT 

LD 

IX,  HL 

LD 

B,0 

LD 

HL,0 

LD 

A,i9tUGii$ 

RST 

28H 

INC 

HL 

PUSH 

IX 

POP 

DE 

XOR 

A 

SBC 

HL,DE 

JR 

N2,CANT 

LD 

HL, CIX+2) 

LD 
LD 
RST 

B,0 

A,@HIGH$ 

28H 

LD 
LD 
RST 

HL,OK 

A,@DSPLY 
28H 

LD 
RST 

A, @ EXIT 
28H 

all  is  well 


;Call  the  @HIGH$  svc 

;Point  to  a  message  saying 

;and  print  it 

;Call  the  @DSPLY  svc 

;Exit  the  main  program 
;Call  the  §EXIT  svc 


Here  we  will  display  a  message  saying  we  removed  the  task  from 
the  scheduler  table,  but  we  cannot  reclaim  the  memory  that  was 
used. 


LD 

LD 
RST 

LD 
RST 


HL,RECLM 
A,@DSPLY 
28H 

A, 6 EXIT 
28H 


; Point  to  the  message 
;and  display  it 
;Call  the  @DSPLY  svc 


;Now  exit 

;Call  the 


JEXIT  svc 


;       Messages 

ADDED:   DEFM  'Task  placed  in  high  memory  and  scheduled.' 

DEFB  0DH 

OK:     DEFM  'Task  removed  from  scheduler  table  and  memory  reclaimed.' 

DEFB  0DH 

RECLM:   DEFM  'Task  removed  from  scheduler  table,  but  memory  could  not 
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Sample  Program  F5  continued 


00204 
#0205 
00206 
00207 
00208 
00209 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00218 
00219 
00220 
00221 
00222 
00223 
00224 
00225 
00226 
00227 
00228 
00229 
00230 
00231 
00232 
00233 
00234 
00235 
00236 
00237 
00238 
00239 
00240 
00241 
00242 
00243 
00244 
00245 
00246 
00247 
00248 
00249 
00250 
00251 
00252 
00253 
00254 
00255 
00256 
00257 
00258 
00259 
00260 
00261 
00262 


DEFM 
DEFB 


'be  recovered. 

0DH 


The  Task  begins  at  this  point.   This  part  of  the  program  loads 
in  low  memory  but  is  relocated  to  a  point  just  below  HIGH? . 

This  is  the  Memory  Header  Block.   This  block  of  data  allows 
the  system  to  locate  this  module  in  memory  by  name, 
using  the  @GTMOD  svc . 


MODULE: 

ENDADD : 


JR 

DEFW 


ENTRY 


DEFB 
DEFM 


MODTCB:  DEFW 


MODTCB-MODNAM 

'UPTIME' 


;Jump  (relative)  to  the  starting  address 
;The  highest  address  in  the  program. 
;This  value  is  patched  in  before  the  program 
;is  relocated.   This  will  be  used 
zlater  in  recovering  the  memory  used  by 
;this  task. 

;Number  of  bytes  in  the  name  field  below. 
;This  is  the  name  of  the  module  and  is 
:used  to  identify  the  module. 
; Actual  address  to  start  execution.   This 
rvalue  is  patched  in  after  the  program  is 
;relocated. 
DEFW    0  ;Spare  system  pointer  -  RESERVED 

This  area  contains  data  used  by  the  task.   It  is  addressed  using 
the  IX  register  which  points  to  the  task  when  it  is  executed. 


COUNTER: DEFW 
DATBUF:  DEFS 


;Count  of  how  many  times  we  have  run 
;The  date  is  stored  here 


This  is  the  actual  task. 

On  entry  to  the  task,  IX  points  at  the  Task  Control  Block  CTCB) , 
which  in  this  program  is  the  label  'MODTCB'.   All  data  is 
referenced  by  indexing  from  that  address. 

PUSH    IY.  ;Save  this  register.   It  is  not  saved  by 

;the  Task  Scheduler,  and  we  use  it. 
; Registers  AF,  BC,  DE,  and  HL  are  saved 

Now  we  will  read  the  current  date. 

;Get  a  copy  of  the  index  pointer 
BC,DATBUF~MODTCB;Get  the  offset  needed  to  access  the  date 
;Now  we  have  a  pointer  to  the  date 

;Save  the  pointer  to  the  start  of  the  task 

;Save  a  copy  of  that  pointer 

;Ask  the  system  what  the  date  is 
;Call  the  ©DATE  svc 

;Terminate  the  date  string 

;Put  pointer  to  the  date  here 

;We  will  use  this  pointer  later  on 

;Put  the  cursor  on  the  top  line, 

specified  in  register  HL 

;at  the  41st  position  on  the  screen 

;Write  the  message  at  the  position 

;Save  the  registers  we  damage 

;Save  it 

;Save  it 

;Get  our  current  address 

;Call  the  ©WHERE  svc 

;Get  the  lengths  of  the  instructions  after 

;the  SVC.   This  will  allow  the  subroutine 

;to  return  to  the  correct  address . 


LD 

HL,IX 

LD 

BC ,  DATB 

ADD 

HL,BC 

PUSH 

IX 

PUSH 

HL 

LD 

A, ©DATE 

RST 

28H 

(HL)  ,0 


POP 

DE 

PUSH 

DE 

LD 

HL,0028H 

CALLR 

WRITE 

PUSH 

HL 

PUSH 

BC 

PUSH 

AF 

LD 

A,  ©WHERE 

RST 

28H 

LD 

BC, 3+1+1+1+1+2 

Software  181 


Sample  Program  F,  continued 


00263 
0026  4 
00265 
00266 
00267 
00268 
00269 
00270 
00271 
00272 
00273 
00274 
00275 
00276 
00277 
00278 
00279 
00280 
00281 
00282 
00283 
00284 
00285 
00286 
00287 
00288 
00289 
002  90 
00291 
00292 
00293 
00294 


00295 
00296 
00297 
00298 
00299 
00300 
00301 
00302 
00303 
00304 
00305 
00306 
00307 
00308 
00309 
00310 
00311 
00312 


ADD 

HL,BC 

POP 

AF 

POP 

BC 

EX 

(SP) ,HL 

JR 

WRITE 

;Add  that  offset  to  where  we  are 

;Put  stack  back 

; Restore  registers 

;Put  return  address  on  stack  and  restore  HL 

;Jump  to  the  subroutine 

;Note  that  the  above  was  actually  a  macro 

;which  performs  a  relative  call. 

This  part  of  the  task  displays  a  count  of  the  number  of  times 
the  task  has  been  executed. 

;Get  the  pointer  to  DATBUF  back 
;Get  the  pointer  to  the  beginning  of 
;this  task 

;Save  the  pointer  to  DATBUF  again 
:B      ;Get  the  offset  to  our  data 
;area 
;Put  a  copy  of  the  base  address  in  HL 
;Add  offset.   Now  HL  points  to  COUNTER: 
;Put  the  pointer  to  COUNTER  in  IY 
;Get  LSB  of  the  counter 
;Get  MSB  of  the  counter 

; Increment  the  number  of  times  we  have  run 
;Store  the  LSB  of  the  counter 
;Store  the  MSB  of  the  counter 

;Convert  the  count  to  decimal 
;Call  the  @HEXDEC  sve 

;Get  a  zero 

;Terminate  the  count  string 

;Put  pointer  to  date  here 

;Put  the  cursor  on  the  top  line, 

specified  in  register  HL 

;at  the  55th  position  on  the  screen 

;Write  the  message  at  the  position 

;Save  the  registers  we  damage 

;Save  it 

;Save  it 

;Get  our  current  address 

;Call  the  @WHERE  svc 

;Get  the  lengths  of  the  instructions  after 

;the  SVC.   This  will  allow  the  subroutine 

;to  return  to  the  correct  address. 

;Add  that  offset  to  where  we  are 

;Put  stack  back 

; Restore  registers 

;Put  return  address  on  stack  and  restore  HL 

;Jump  to  the  subroutine 

;Note  that  the  above  was  actually  a  macro 

;which  performs  a  relative  call. 

Now  we  restore  the  IY  register  and  return  to  the  task  scheduler. 


POP 

DE 

POP 

IX 

PUSH 

DE 

LD 

BC, COUNTER-MODI 

LD 

HL,IX 

ADD 

HL,BC 

LD 

IY,HL 

LD 

L, (IY) 

LD 

H, (IY+1) 

INC 

HL 

LD 

(IY)  ,L 

LD 

UY+1) ,H 

LD 

A,@HEXDEC 

RST 

28H 

XOR 

A 

LD 

(DE) ,A 

POP 

DE 

LD 

HL,0036H 

CALLR 

WRITE 

PUSH 

HL 

PUSH 

BC 

PUSH 

AF 

LD 

A,@WHERE 

RST 

28H 

LD 

BC, 3+1+1+1+1+2 

ADD 

HL,BC 

POP 

AF 

POP 

BC 

EX 

(SP) ,HL 

JR 

WRITE 

POP 
RET 


;Restore  IY  value 

;Return  to  the  task  scheduler 


This  routine  places  characters  on  the  display  using  the  @VDCTL 
svc  instead  of  §DSP  or  @DSPL¥*   This  allows  the  cursor  to 
remain  at  its  current  position  when  we  write  to  the  screen. 
This  routine  must  be  called  using  the  relocatable  call  macro 
CALLR. 


WRITE:   LD       B,2 
TSKLP:   LD       A,(DE) 


;Put  character  on  the  display 
;Get  a  character  to  display 
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Sample  Program  F,  continued 


00313 

OR 

A 

.00314 

00315 

RET 

Z 

00316 

PUSH 

HL 

00317 

PUSH 

DE 

00318 

PUSH 

BC 

00319 

LD 

C,A 

00320 

LD 

A,@VDCTL 

00321 

RST 

28H 

00322 

POP 

BC 

00323 

POP 

DE 

00324 

POP 

HL 

00325 

INC 

L 

00326 

INC 

DE 

00327 

JR 

TSKLP 

00328 

00329    MODEND:  END 

BEGIN 

;Is  it  time  to  stop  putting  this  on 

;the  display? 

;Yes ,    return  to  the  caller 

;Save  the  registers,  as  the  SVC  will 

;alter  the  contents 

;Put  the  character  here 

;Put  character  on  screen  at  specified  position 

;Call  the  @VDCTL  svc 

;Restore  registers 


;Advance  display  position 

;Point  to  next  character  to  display 

;Loop  till  date  is  completely  displayed 

;End  of  task  and  main  program 
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Sample  Program  G 


00001 
00002 
00003 


00012 
00013 
00014 
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 
00023 
J3J0024 
00025 
00026 
00027 
00028 
00029 
00030 
00031 
00032 
00033 
00034 
00035 
00036 
00037 
00038 
00039 


This  program  is  a  sample  Extended  Command  Interpreter.   You 

may  make  the  ECI  as  large  or  small  as  you  require.   You  may 

use  allof  main  memory,  or  you  can  restrict  yourself  to  the 

system  overlay  area  (x'2600'  to  x^FFF*). 

To  pass  a  command  to  the  normal  system  interpreter  for 

processing,  use  the  @CMNDI  svc.   TRSDOS  executes  the  command 

and  reloads  the  ECI.   If  you  want  to  have  multiple  entry 

points,  Bits  2  -  0  in  EFLAG$  are  in  Register  A  on  entry 

(in  Bits  6  -  4), or  you  may  read  EPLAG?  yourself. 

EFLAG?  is  totally  dedicated  to  the  ECI,  and  may  contain  any 

non-zero  value.   If  EFLAG$  contains  a  zero,  TRSDOS  uses  its 

own  interpreter.   Other  programs  that  want  to  activate  an  ECI, 

should  set  the  EFLAG$  to  a  non-zero  value  and  execute  a  @EXIT 

svc. 

To  install  an  ECI,  use  the  command: 

COPY  filename  SYS13/SYS .LSIDOS : d  (C^N> 
If  you  omit  the  C=N  option,  the  SYS13  file  loses  it's  "SYS" 
status  and  you  will  receive  'Error  07'  messages  when  you  try 
to  use  it  as  a  ECI. 

When  SYSi  (the  normal  command  interpreter)  has  completed  it's 

normal  housekeeping  and  is  about  to  display  the  "TRSDOS  Ready" 

prompt,  it  checks  fcitLAG^.   If  fcFLAG$  contains  a  non-zero 

value,  TRSDOS  loads  and  executes  the  Extended  Command 

Interpreter. 

To  execute  this  program,  type  <*><Enter>. 

This  program  checks  EFLAG$  to  see  if  it  is  zero.   If  so,  it 
sets  it  to  a  non-zero  value.   This  causes  this  program  to  be 
used  instead  of  the  normal  interpreter  when  you  execute  an 
(3EXIT  or  @ABORT  SVC.   (@CMNDI  and  §CMNDR  invoke  the  TRSDOS 
interpreter.)   If  EFLAG$  is  non-2ero,  the  ECI  displays  a  few 
prompts  and  the  names  of  all  visible  /CMD  files  on  logical 
Dr  i  ve  0 . 
The  operator  may  then  type  the  name  of  a  program  to  execute. 

If  you  press  <Break> ,   this  program  sets  EPLAG$  to  0,  executes 
an  @EXIT  SVC  and  returns  to  TRSDOS  Ready. 


00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 


By  pressing  a  number,  0  through  7,  you  can  specify  the  drive 
that  TRSDOS  searches.   This  program  stores  this  value  in 
EFLAG$ .   Each  time  this  program  is  invoked,  it  reads  the  value 
from  EFLAG$  and  uses  that  drive. 

Note  that  if  a  drive  is  not  enabled,  not  formatted,  doesn't 
exist,  or  contains  no  visible  /CMD  files,  this  program 
redisplays  the  prompt- 


00050 
00051 
00052 
00053 


00063 
00064 
00065 
0006  6 
00067 
00068 


PRINT    SHORT, NOMAC 
PSECT    3000H 


;This  program  starts  at 


'3000' 


Declare  the  equates  for  the  SVCs  used. 


00055 

This  is 

00056 

follow. 

00057 

@EXIT: 

EQU 

00058 

@DSPLY: 

EQU 

0005  9 

©FLAGS: 

EQU 

00060 

@DODIR: 

EQU 

00061 

@KEYIN: 

EQU 

00062 

SCMNDI: 

EQU 

not  mandatory,  but  it  makes  the  program  easier  to 


22 

10 

101 

34 

9 

24 


;Exit  and  return  to  TRSDOS 

;Display  a  string 

;Locate  the  system  flag  area 

;Get  the  names  of  filenames 

;Accept  a  command  and  allow  editing 

; Execute  a  command  (using  SYSI ) 


On  entry,  determine  if  EPLAG$  is  set  to  zero  or  not.   If  it 
is  set  to  zero,  this  program  is  being  started  by  typing 
PROGRAM<Enter>  or  <*><Enter>.   In  that  case,  set  EFLAG$  to  a 
non-zero  value  so  that  in  future,  TRSDOS  uses  this  interpreter 
instead  of  it's  own. 
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00069 


73 
00074 
00075 
00076 
00077 
0007  8 
00079 


31 
00082 
93 
34 
35 
36 
37 


00089 


91 
92 
00093 
00094 
00095 
96 
97 


00101 
00102 
00103 
00104 
00105 
00106 
00107 


00109 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00118 
00119 
00120 
00121 
00122 
00123 
00124 
00125 
00126 
00127 
00128 
00129 
00130 
00131 
0013  2 
00133 
00134 
00135 
00136 


Sample  Program  G,  continued 

If  EFLAG$  is  non-zero,  this  initialization  has  already  been 
done  and  can  be  skipped . 


LD 

RST 

LD 
OR 

JR 


LD 
LD 
JR 


A, @ FLAGS 

28H 

A,  (IY+4) 

A 

NZ,ECIRUN 

A, 8 


(IY+4)  ,A 
HL, PROMPT 
ECIGO 


;Get  the  starting  address  of:  the  flag 

;Call  the  @FLAGS  svc 

;Read  the  EFLAG$  {ECI  flag) 
;Is  it  set  to  zero? 
;Run  the  ECI 

;Get  a  non-zero  value .   The  value 

; needs  to  be  a  non-zero  value  that 

;does  not  set  Bits  0,  1  or  2.   The 

; default  drive  #  is  kept  in  these  bits. 

;Set  the  EFLAG$  to  a  non-zero  value 

;Explain  how  this  works 

;Display  message 


;       When  the  system  is  about  to  display 

;       TRSDOS  Ready,  it  executes  this  code  instead. 

ECIRUN:  LD       HL,SPROMPT      ;Point  at  the  prompt  to  use 
ECIGO:   LD      A,@DSFLY       ;Display  the  prompt 

RST      28H  ;Call  the  @DSPLY  svc 

;        Display  the  names  of  all  /CMD  files 


LD 

A,  (IY+4) 

AND 

7 

LD 

C,A 

LD 

A,@DODIR 

LD 

B,2 

LD 

HL,CMDTXT 

RST 

28H 

;Get  the  EFLAG$ 

;Delete  all  but  the  drive  number  field 

;Store  the  drive  number  for  the  svc 

;Do  a  directory  display 

;Display  visible,  non-system  files 

;that  match  "CMD"  (stored  at  CMDTXT) 

;Call  the  @DODIR  svc 


Prompt  for  a  filename  or  a  function  key. 


LD 

HL, BUFFER 

LD 

B,9 

LD 

C,0 

LD 

A,@KEYIN 

RST 

28H 

LD 
LD 


CP 
JR 


SUB 

CP 

JR 


CQUIT 


HL, BUFFER 
A, (HL) 


0DH 
Z,ASK 


7+1 

NC, NAME 


;Point  at  text  buffer 

;Allow  up  to  8  characters  and  <Enter> 

;Required  by  the  svc 

;Input  text  with  edit  capability 

;Call  the  @KEYIN  svc 

;The  carry  flag  is  set  when  the 
;operator  presses  <BREAK>.  Zero  the 
;EFLAG$  and  exit  to  TRSDOS 

;Point  at  the  start  of  the  buffer 
;Get  the  character 

;Did  they  type  anything? 
;No,  just  repeat  the  prompt. 
;If  you  want  to  redisplay  the 
;directory,  change  "ASK"  to  "ECIRUN". 

; Con  ve  r  t  va 1 ue  to  binary 
;Is  the  character  a  0  -  7? 
;Must  be  a  filename 


The  operator  has  typed  1  or  more  characters  that  start  with 
a  number.   This  program  assumes  that  the  operator  is  defining 
a  new  drive  number  and  stores  this  value  in  EFLAG$  for 
future  use.   TRSDOS  does  not  alter  this  value. 
The  next  time  this  program  is  run,  EFLAGS  contains  the 
same  value  and  this  program  knows  what  drive  to  scan. 


LD 
LD 


B,A 

A,  (IY+4) 


;Save  the  drive  number 
;Get  the  EFLAG$ 
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Sample  Program  G,  continued 


00137 
00138 
00139 


00141 

00142 

00143 

00144 

00145 

00146 

00147 

00148 

00149 

00150 

00151 

00152 

0015  3 

00154 

00155 

00156 

00157 

00158 

00159 

00160 

00161 

00162 

00163 

00164 

EFLAG$ 

00165 

00166 

00167 

00168 

00169 


QUIT: 


NAME: 
FDIV: 


00171 
00172 
00173 
00174 
00175 
00176 
00177 
00178 
00179 
00179 
00180 
00181 
00182 
00183 
00184 
00185 
00186 
00187 
00188 
00189 
00190 
00191 

00192 
00193 

00194 
00195 
00196 
00197 

00198 
00199 
00200 


AND 
OR 
LD 
JR 


(IY+4) ,A 
ECIRUN 


;Delete  the  old  drive  number 
? Insert  the  new  drive  number 
;Save  that  value  for  future  use 
;Scan  the  new  drive 


The  operator  pressed  <Break> .   Turn  off  the  ECI  and  return  to 

TRSDOS . 

XOR  A  ;Get  a  zero 

LD  (IY+4),A  ;Set  EFLAG$  to  zero 

LD  HL,EPROMPT  ; Point  at  the  shutdown  message 

LD  A,@DSPLY  ;And  acknowledge  the  <Break> 

RST  28H  ;Call  the  @DSPLY  svc 

LD  A,@EXIT  ; Return  to  TRSDOS  Ready 

RST  28H  ;Call  the  @EXIT  svc 

The  operator  entered  what  might  be  a  filename  or  a  library 
command.   Pass  it  to  TRSDOS  for  processing.   If  there  is  an 
error,  TRSDOS  is  responsible  for  determining  what  the  error  is 
and  printing  a  message. 
(HL  already  points  at  the  start  of  the  buffer.) 


LD 

CP 

JR 

INC 

JR 


A,0DH 

(HL) 

Z, FOUND 

HL 

FDIV 


;Look  for  this  character 

;In  the  command 

;Found  the  end  of  the  filename 

;Move  character  to  next  byre 

;Find  the  divider  (in  this  case,  a  0DH) 


LD 

(HL) , ■ : ■ 

INC 

HL 

LD 

A,  (IY+4) 

AND 

7 

ADD 

A,  '0' 

LD 

(HL) ,A 

INC 

HL 

LD 

(HL) ,0DH 

LD 

HL, BUFFER 

LD 

A,@CMNDI 

PROMPT:  DEFM 
DEFB 
DEFB 
DEFM 
DEFB 
DEFM 

DEFB 

DEFM 


SPROMPTrDEFB 
DEFM 


Found  the  end  of  a  filename,  and  add  the  drive  number  from 

Note  that  this  program  may  not  work  properly  if  the  operator 
supplies  a  drive  number  as  part  of  the  filename. 

;Add  a  drive  number  to  the  filename 
;Advance  the  pointer  to  the  next  byte 
;Get  the  EFLAG$  value 
; Delete  all  but  the  drive  number 
;Convert  the  binary  value  to  ASCII 
;Add  that  to  the  filename 
;Advance  the  pointer  to  the  next  byte 
;Write  a  terminator  on  the  end 
; Point  at  the  text  entered 
;Execute  the  command,  but  do  not 
;return.  Since  this  program  is  the 
command  processor  at  this  time, TRSDOS 
;returns  control  to  the  beginning  of 
;this  module  after  executing  the 
; command. 
RST      28H  ;Call  the  @CMNDI  svc 

Messages  and  text  storage 

'[Extended  Command  Interpreter  Is  Now  Operational]* 

0AH 

0AH 

•Press  <BREAK>  to  use  the  normal  interpreter, 

0AH 

'type    <NumberXENTER>    to  change   the  default   drive 

number , ' 

0AH 

•or  type  the  name  of  the  program  to  run  and  press 

<ENTER>* 

0DH  ;Terminate  the  display 

0AH 

'EECI  On]  <BREAK>  to  abort,  n<ENTER>  for  new  drive  or 
type: ' 

■  program<ENTER> ' 

0DH  ;Terminate  the  message 


DEFM 
DEFB 
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Sample  Program  G,  continued 


00201  EPROMPT:DEFM  '[Extended  Command  Interpreter  Is  Now  Disabled]' 

00202  DEFB  0DH 
00203 

00204  CMDTXT:  DEPM  'CMD' 

00205  BUFFER:  DEFS  11  ;Allow  for  filename,  drivespec  ana  0DH 
00206 

00207  END  BEGIN  ;  "BEGIN"  is  the  starting  address 
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9/Technical  Information  on  TRSDOS 
Commands  and  Utilities 


TRSDOS  commands  and  utilities  are  covered  extensively  in  the  Disk  System 
Owner's  Manual,  This  section  presents  additional  information  of  a  technical 
nature  on  several  of  the  commands  and  utilities 


Changing  the  Step  Rate 


The  step  rate  is  the  rate  at  which  the  drive  head  moves  from  cylinder  to  cylinder 
You  can  change  the  step  rate  for  any  drive  by  using  one  of  the  commands 
described  below. 

To  set  the  step  rate  for  a  particular  drive,  use  the  following  command: 

SYSTEM  (DRIVE  =  drive,  STEP  =  number) 

drive  is  any  drive  enabled  in  the  system.,  number  can  be  0, 1,  2,  or  3  and  rep- 
resents one  of  the  following  step  rates  in  milliseconds: 

0  =  6  milliseconds 

1  =12  milliseconds 

2  =  20  milliseconds 

3  =  30  milliseconds 

Unless  it  is  SYSGENed,  the  step  value  you  select  remains  in  effect  for  the  spec- 
ified drive  oniy  until  the  system  is  re-booted  or  turned  off,,  !f  you  use  the 
SYSGEN  command  while  the  step  value  is  in  effect,  then  this  step  rate  is  written 
to  the  configuration  file  (CONFIG/SYS)  on  the  disk  in  the  drive  specified  by  the 
SYSGEN  command., 

On  a  new  TRSDOS  disk,  the  step  rate  is  set  to  12  milliseconds. 

To  set  the  default  bootstrap  step  rate  used  with  the  FORMAT  utility,  use  the  fol- 
lowing command: 

SYSTEM  (BSTEP  =- number) 

number  is  0,  1,  2,  or  3,  which  correspond  to  6,  12,  20,  and  30  milliseconds, 
respectively* 

The  value  you  select  for  number  is  stored  in  the  system  information  sector  on 
the  disk  in  Drive  0„  (On  a  new  TRSDOS  disk,  the  bootstrap  step  rate  is  set  to  12 
milliseconds.) 

If  you  switch  Drive  0  disks  or  change  the  logical  Drive  0  with  the  SYSTEM 
(SYSTEM)  command,  the  default  value  is  taken  off  the  new  Drive  0  disk  if  you 
format  a  disk. 

You  can  change  the  bootstrap  step  rate  for  a  particular  FORMAT  operation  if 
you  do  not  want  to  use  the  default  Specify  the  new  value  for  STEP  on  the 
FORMAT  command  line  as  follows: 

FORMAT  .-drive  (STEP  =  number) 

drive  is  the  drive  to  be  used  for  the  FORMAT  number  is  0, 1,  2,  or  3,  which  cor- 
respond to  6, 12,  20,  and  30  milliseconds,  respectively. 

The  step  rate  is  important  only  if  you  will  be  using  the  disk  in  Drive  0  to  start  up 
the  system.  Keep  in  mind  that  too  low  a  step  rate  may  keep  the  disk  from 
booting, 
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Changing  the  WAIT  Value 


The  WAIT  parameter  compensates  for  hardware  incompatibility  between  cer- 
tain disk  drives.  The  only  time  you  should  use  it  is  when  all  tracks  above  a  cer- 
tain point  during  a  FORMAT  operation  are  shown  as  locked  out  when  the 
FORMAT  is  verified. 

The  value  assigned  to  WAIT  signifies  the  amount  of  time  between  the  arrival  of 
the  drive  head  at  the  location  for  a  read  or  write,  and  the  actual  start  of  the  read 
or  write. 

If  you  want  to  change  the  WAIT  value,  specify  the  new  value  on  the  FORMAT 
command  line  as  follows: 

FORMAT  :dhve  (WAIT -number) 

number  is  a  value  between  5000  and  50000,.  The  exact  value  depends  on  the 
particular  disk  drive  you  are  using.  We  recommend  that  you  use  a  value  around 
25000  at  first.  Adjust  this  value  higher  if  tracks  are  still  locked  out,  or  lower  until 
the  bottom  limit  is  determined. 


Logging  in  a  Diskette 


LOG  is  a  utility  program  that  logs  in  the  directory  track,  number  of  sides,  and 
density  of  a  diskette,.  The  syntax  is: 

LOG  .drive 

drive  is  any  drive  currently  enabled  in  the  system,. 

The  LOG  utility  provides  a  way  to  log  in  diskette  information  and  update  the 
drive's  Drive  Code  Table  (DCT).  It  performs  the  same  log-in  function  as  the 
DEVICE  library  command,  except  for  a  single  drive  rather  than  all  drives.  It  also 
provides  a  way  to  swap  the  Drive  0  diskette  for  a  double-sided  diskette. 

The  LOG  :0  command  prompts  you  to  switch  the  Drive  0  diskette.  You  must  use 
this  command  when  switching  between  double-  and  single-sided  diskettes  in 
Drive  0.  Otherwise,  it  is  not  needed. 

Example 

If  you  want  to  switch  disks  in  Drive  0,  type: 
LOG    :Q    (ENTER) 

The  system  prompts  you  with  the  message: 

Exchange  disKs  and  hit  <ENTER> 

Remove  the  current  disk  from  Drive  0  and  insert  the  new  system  disk.  When 
you  press  (ENTER),  information  about  the  new  disk  is  entered  to  the  system. 


Printing  Graphics  Characters 


If  your  printer  is  capable  of  directly  reproducing  the  TRS-80  graphics  charac- 
ters, you  can  use  the  SYSTEM  (GRAPHIC)  command.  Once  you  have  issued 
this  command,  any  graphics  characters  on  the  screen  will  be  sent  to  the  line 
printer  during  a  screen  print.  (Pressing  (CTRDCD  causes  the  contents  of  the 
video  display  to  be  printed  on  the  printer) 

Do  not  use  this  command  unless  your  printer  is  capable  of  directly  reproducing 
the  TRS-80  graphics  characters. 
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Changing  the  Clock  Rate 


The  system  normally  runs  at  the  fast  clock  rate  of  4  megahertz, 

A  slow  mode  of  2  megahertz  is  available,  and  may  be  necessary  for  real  time- 
dependent  programs  (This  slow  rate  is  the  same  as  the  Model  III  clock  rate.) 

To  switch  to  the  slow  rate,  enter  the  following  command: 

SYSTEM  (SLOW) 
To  switch  back  to  the  fast  rate,  enter: 

SYSTEM  (FAST) 
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Appendix  A/TRSDOS  Error  Messages 


If  the  computer  displays  one  of  the  messages  listed  in  this  appendix,  an  oper- 
ating system  error  occurred.,  Any  other  error  message  may  refer  to  an  applica- 
tion program  error,  and  you  should  check  your  application  program  manual  for 
an  explanation. 

When  an  error  message  is  displayed: 

•  Try  the  operation  several  times, 

•  Look  up  operating  system  errors  below  and  take  any  recommended 
actions.  (See  your  application  program  manual  for  explanations  of  appli- 
cation program  errors.) 

•  Try  using  other  diskettes, 

•  Reset  the  computer  and  try  the  operation  again. 

•  Check  all  the  power  connections, 

•  Check  all  interconnections. 

•  Remove  all  diskettes  from  drives,  turn  off  the  computer,  wait  15  seconds, 
and  turn  it  on  again. 

•  If  you  try  all  these  remedies  and  still  get  an  error  message,  contact  a 
Radio  Shack  Service  Center 

Note:  If  there  is  more  than  one  thing  wrong,  the  computer  might  wait  until  you 
correct  the  first  error  before  displaying  the  second  error  message. 

This  list  of  error  messages  is  alphabetical,  with  the  binary  and  hexadecimal 
error  numbers  in  parentheses.  Following  it  is  a  quick  reference  list  of  the  mes- 
sages arranged  in  numerical  order. 

Attempted  to  read  locked/deleted  data  record  (Error  7,  X'07') 

In  a  system  that  supports  a  "deleted  record"  data  address  mark,  an  attempt  was 
made  to  read  a  deleted  sector.  TRSDOS  currently  does  not  use  the  deleted 
sector  data  address  mark.  Check  for  an  error  in  your  application  program. 

Attempted  to  read  system  data  record  (Error  6,  X  W) 

An  attempt  was  made  to  read  a  directory  cylinder  sector  without  using  the 
directory  read  routines,  Directory  cylinder  sectors  are  written  with  a  data 
address  mark  that  differs  from  the  data  sector's  data  address  mark,  Check  for 
an  error  in  your  application  program. 

Data  record  not  found  during  read  (Error  5,  XW) 

The  sector  number  for  the  read  operation  is  not  on  the  cylinder  being  refer- 
enced. Either  the  disk  is  flawed,  you  requested  an  incorrect  number,  or  the  cyl- 
inder is  improperly  formatted,  Try  the  operation  again.  If  it  fails,  use  another 
disk.  Reformatting  the  old  disk  should  lock  out  the  flaw. 

Data  record  not  found  during  write  (Error  13,  X*0D') 

The  sector  number  requested  for  the  write  operation  cannot  be  found  on  the 
cylinder  being  referenced.  Either  the  disk  is  flawed,  you  requested  an  incorrect 
number,  or  the  cylinder  is  improperly  formatted,  Try  the  operation  again.  If  it 
fails,  use  another  disk. 

Device  in  use  (Error  39,  X(27') 

A  request  was  made  to  REMOVE  a  device  (delete  it  from  the  Device  Control 
Block  tables)  while  it  was  in  use.  RESET  the  device  in  use  before  removing  it. 
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Device  not  available  (Error  8,  X'08') 

A  reference  was  made  for  a  logical  device  that  cannot  be  found  in  the  Device 
Control  Block.  Probably,  your  device  specification  was  wrong  or  the  device 
peripheral  was  not  ready.  Use  the  DEVICE  command  to  display  all  devices 
available  to  the  system. 

Directory  full  —  can't  extend  file  (Error  30,  X*1  E') 

A  file  has  all  extent  fields  of  its  last  directory  record  in  use  and  must  find  a  spare 
directory  slot  but  none  is  available.  (See  the  "Directory  Records"  section.)  Copy 
the  disk's  files  to  a  newly  formatted  diskette  to  reduce  file  fragmentation,  You 
may  use  backup  by  class  or  backup  reconstruct  to  reduce  fragmentation. 

Directory  read  error  (Error  17,  X'1f) 

A  disk  error  occurred  during  a  directory  read.  The  problem  may  be  media,  hard- 
ware, or  program  failure.  Move  the  disk  to  another  drive  and  try  the  operation 
again,, 

Directory  write  error  (Error  18,  X'12') 

A  disk  error  occurred  during  a  directory  write  to  disk,  The  directory  may  no 
longer  be  reliable.  If  the  problem  recurs,  use  a  different  diskette. 

Disk  space  full  (Error  27  X'lB') 

While  a  file  was  being  written,  all  available  disk  space  was  used.  The  disk  con- 
tains only  a  partial  copy  of  the  file.  Write  the  file  to  a  diskette  that  has  more  avail- 
able space.  Then,  REMOVE  the  partial  copy  to  recover  disk  space, 

End  of  file  encountered  (Error  28,  X'1C) 

You  tried  to  read  past  the  end  of  file  pointer,  Use  the  DIR  command  to  check  the 
size  of  the  file,  This  error  also  occurs  when  you  use  the  @PEOF  supervisor  call 
to  successfully  position  to  the  end  of  a  file  Check  for  an  error  in  your  application 
program, 

Extended  error  (Error  63) 

An  error  has  occurred  and  the  extended  error  code  is  in  the  HL  register  pair;. 

File  access  denied  (Error  25,  X'19') 

You  specified  a  password  for  a  file  that  is  not  password  protected  or  you  spec- 
ified the  wrong  password  for  a  file  that  is  password  protected. 

File  already  open  (Error  41,  X'29') 

You  tried  to  open  a  file  for  UPDATE  level  or  higher,  and  the  file  already  is  open 
with  this  access  level  or  higher.  This  forces  a  change  to  READ  access  protec- 
tion, Use  the  RESET  library  command  to  close  the  file. 

File  not  in  directory  (Error  24,  X'18') 

The  specified  filespec  cannot  be  found  in  the  directory.  Check  the  spelling  of 
the  filespec. 

File  not  open  (Error  38,  X'26'} 

You  requested  an  I/O  operation  on  an  unopened  file.  Open  the  file  before 
access 

GAT  read  error  (Error  20,  X'14') 

A  disk  error  occurred  during  the  reading  of  the  Granule  Allocation  Table,  The 
problem  may  be  media,  hardware,  or  program  failure,.  Move  the  diskette  to 
another  drive  and  try  the  operation  again, 

GAT  write  error  (Error  21,  X'15') 

A  disk  error  occurred  during  the  writing  of  the  Granule  Allocation  Tabie.  The 
GAT  may  no  longer  be  reliable.  If  the  problem  recurs,  use  a  different  drive  or 
different  diskette. 
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HIT  read  error  (Error  22,  X'16') 

A  disk  error  occurred  during  the  reading  of  the  Hash  Index  Table.  The  problem 
may  be  media,  hardware,  or  program  failure  Move  the  diskette  to  another  drive 
and  try  the  operation  again , 

HIT  write  error  (Error  23,  X*17') 

A  disk  error  occurred  during  the  writing  of  the  Hash  Index  Table,  The  HIT  may 
no  longer  be  reliable.  If  the  problem  recurs,  use  a  different  drive  or  different 
diskette- 

illegal  access  attempted  to  protected  file  (Error  37,  X'25') 

The  USER  password  was  given  for  access  to  a  file,  but  the  requested  access 
required  the  OWNER  password.  (See  the  ATTRIB  library  command  in  your 
Disk  System  Owner's  Manual,) 

Illegal  drive  number  (Error  32,  X'20') 

The  specified  disk  drive  is  not  included  in  your  system  or  is  not  ready  for  access 
(no  diskette,  non-TRSDOS  diskette,  drive  door  open,  and  so  on).,  See  the 
DEVICE  command  in  your  Disk  System  Owner's  Manual) 

Illegal  file  name  (Error  19,  X'13') 

The  specified  filespec  does  not  meet  TRSDOS  filespec  requirements.  See  your 
Disk  System  Owner's  Manual  for  proper  filespec  syntax. 

Illegal  logical  file  number  (Error  16,  Xl10') 

A  bad  Directory  Entry  Code  (DEC)  was  found  in  the  File  Control  Block  (FCB). 
This  usually  indicates  that  your  program  has  altered  the  FCB  improperly.  Check 
for  an  error  in  your  application  program. 

Load  file  format  error  (Error  34,  X'22') 

An  attempt  was  made  to  load  a  file  that  cannot  be  loaded  by  the  system  loader. 
The  file  was  probably  a  data  file  or  a  BASIC  program  file. 

tost  data  during  read  (Error  3,  X'03') 

During  a  sector  read,  the  CPU  did  not  accept  a  byte  from  the  Floppy  Disk  Con- 
troller (FDC)  data  register  in  the  time  allotted,,  The  byte  was  lost.,  This  may  indi- 
cate a  hardware  problem  with  the  drive.  Move  the  diskette  to  another  drive  and 
try  again.  If  the  error  recurs,  try  another  diskette. 

Lost  data  during  write  (Error  11,  X'0B') 

During  a  sector  write,  the  CPU  did  not  transfer  a  byte  to  the  Floppy  Disk  Con- 
troller (FDC)  in  the  time  allotted.,  The  byte  was  lost;  it  was  not  transferred  to  the 
disk.  This  may  indicate  a  hardware  problem  with  the  drive.  Move  the  diskette  to 
another  drive  and  try  again,  if  the  error  recurs,  try  another  diskette, 

LRL  open  fault  (Error  42,  X'2A') 

The  logical  record  length  specified  when  the  file  was  opened  is  different  than 
the  LRL  used  when  the  file  was  created.  COPY  the  file  to  another  file  that  has 
the  specified  LRL. 

No  device  space  available  (Error  33,  X'21') 

You  tried  to  SET  a  driver  or  filter  and  all  of  the  Device  Control  Blocks  were  in 
use.  Use  the  DEVICE  command  to  see  if  any  non-system  devices  can  be 
removed  to  provide  more  space.  This  error  also  occurs  on  a  "global"  request  to 
initialize  a  new  file  (that  is,  no  drive  was  specified),  if  no  file  can  be  created. 

No  directory  space  available  (Error  26,  X'1A') 

You  tried  to  open  a  new  file  and  no  space  was  left  in  the  directory.  Use  a  differ- 
ent disk  or  REMOVE  some  files  that  you  no  longer  need. 
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No  error  (Error  0) 

The  @ERROR  supervisor  call  was  called  without  any  error  condition  being 
detected,  A  return  code  of  zero  indicates  no  error  Check  for  an  error  in  your 
application  program, 

Parameter  error  (Error  44,X'2C) 

{Under  Version  6.2  only)  An  error  occurred  while  executing  a  command  line  or 
utility  because  a  parameter  that  does  not  exist  was  specified  Check  the  spell- 
ing of  the  parameter  name,  value,  or  abbreviation. 

Parity  error  during  header  read  (Error  1,  X'OV) 

During  a  sector  I/O  request,  the  system  coutd  not  read  the  sector  header  suc- 
cessfully, If  this  error  occurs  repeatedly,  the  problem  is  probably  media  or  hard- 
ware failure.  Try  the  operation  again,  using  a  different  drive  or  diskette. 

Parity  error  during  header  write  (Error  9,  X'09') 

During  a  sector  write,  the  system  could  not  write  the  sector  header  satisfactor- 
ily. If  this  error  occurs  repeatedly,  the  problem  is  probably  media  or  hardware 
failure.  Try  the  operation  again,  using  a  different  drive  or  diskette 

Parity  error  during  read  (Error  4,  X'04') 

An  error  occurred  during  a  sector  read,  Us  probable  cause  is  media  failure  or  a 
dirty  or  faulty  disk  drive.  Try  the  operation  again,  using  a  different  drive  or 
diskette- 
Parity  error  during  write  (Error  12,  X'0C) 

An  error  occurred  during  a  sector  write  operation.  Its  probable  cause  is  media 
failure  or  a  dirty  or  faulty  disk  drive.  Try  the  operation  again,  using  a  different 
drive  or  diskette, 

Program  not  found  (Error  31,  X'1  F) 

The  file  cannot  be  loaded  because  it  is  not  in  the  directory.  Either  the  filespec 
was  misspelled  or  the  disk  that  contains  the  file  was  not  loaded. 

Protected  system  device  (Error  40,  X*28') 

You  cannot  REMOVE  any  of  the  following  devices:  *Kl,  *DO,  *PR,  ML,  *SI,  *SO. 
If  you  try,  you  get  this  error  message. 

Record  number  out  of  range  (Error  29,  X'1D') 

A  request  to  read  a  record  within  a  random  access  file  {see  the  @POSN  super- 
visor call)  provided  a  record  number  that  was  beyond  the  end  of  the  file.  Correct 
the  record  number  or  try  again  using  another  copy  of  the  file. 

Seek  error  during  read  (Error  2,  X'02') 

During  a  read  sector  disk  I/O  request,  the  cylinder  that  should  contain  the  sec- 
tor was  not  found  within  the  time  allotted.  (The  time  is  set  by  the  step  rate  spec- 
ified in  the  Drive  Code  Table,)  Either  the  cylinder  is  not  formatted  or  it  is  no 
longer  readable,  or  the  step  rate  is  too  low  for  the  hardware  to  respond,  You  can 
set  an  appropriate  step  rate  using  the  SYSTEM  library  command,.  The  problem 
may  also  be  caused  by  media  or  hardware  failure.  In  this  case,  try  the  operation 
again,  using  a  different  drive  or  diskette. 

Seek  error  during  write  (Error  10,  X'0A') 

During  a  sector  write,  the  cylinder  that  should  contain  the  sector  was  not  found 
within  the  time  allotted.  (The  time  is  set  by  the  step  rate  specified  in  the  Drive 
Code  Table.)  Either  the  cylinder  Is  not  formatted  or  it  is  no  longer  readable,  or 
the  step  rate  is  too  low  for  the  hardware  to  respond.  You  can  set  an  appropriate 
step  rate  using  the  SYSTEM  library  command.  The  problem  may  also  be 
caused  by  media  or  hardware  failure.  In  this  case,  try  the  operation  again,  using 
a  different  drive  or  diskette 
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—  Unknown  error  code 

The  @ERROR  supervisor  call  was  called  with  an  error  number  that  is  not 
defined.  Check  for  an  error  in  your  application  program- 

Write  fault  on  disk  drive  (Error  14,  X40E') 

An  error  occurred  during  a  write  operation.  This  probably  indicates  a  hardware 
problem.  Try  a  different  diskette  or  drive.  If  the  problem  continues,  contact  a 
Radio  Shack  Service  Center 

Write  protected  disk  (Error  15,  X'OF) 

You  tried  to  write  to  a  drive  that  has  a  write-protected  diskette  or  is  software 
write-protected.,  Remove  the  write-protect  tab,  if  the  diskette  has  one.  If  it  does 
not,  use  the  DEVICE  command  to  see  if  the  drive  is  set  as  write  protected.  If  it 
is,  you  can  use  the  SYSTEM  library  command  with  the  (WP  -  OFF)  parameter 
to  write  enable  the  drive.  If  the  problem  recurs,  use  a  different  drive  or  different 
diskette, 

Numerical  List  of  Error  Messages 

Message 

No  Error 

Parity  error  during  header  read 

Seek  error  during  read 

Lost  data  during  read 

Parity  error  during  read 

Data  record  not  found  during  read 

Attempted  to  read  system  data  record 

Attempted  to  read  locked/deleted  data  record 

Device  not  available 

Parity  error  during  header  write 

Seek  error  during  write 

Lost  data  during  write 

Parity  error  during  write 

Data  record  not  found  during  write 

Write  fault  on  disk  drive 

Write  protected  disk 

Illegal  logical  file  number 

Directory  read  error 

Directory  write  error 

Illegal  file  name 

GAT  read  error 

GAT  write  error 

HIT  read  error 

HIT  write  error 

File  not  in  directory 

File  access  denied 

No  directory  space  available 

Disk  space  full 

End  of  file  encountered 

Record  number  out  of  range 

Directory  full— can't  extend  file 

Program  not  found 

Illegal  drive  number 

No  device  space  available 

Load  file  format  error 

Illegal  access  attempted  to  protected  file 

File  not  open 

Device  in  use 

Protected  system  device 
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ecima 

1       Hex 

0 

XW 

1 

x'or 

2 

X'02* 

3 

X'03' 

4 

X'04' 

5 

X'05' 

6 

X'06' 

7 

X'07' 

8 

X'08' 

9 

X'09' 

10 

X'OA" 

11 

X'OB' 

12 

X'0C 

13 

X'0D' 

14 

X'OE' 

15 

X'OF 

16 

X'10' 

17 

x'ir 

18 

X'12' 

19 

X'13' 

20 

X*14' 

21 

X'15' 

22 

X'16' 

23 

x*ir 

24 

X'18' 

25 

X'19' 

26 

X'1A' 

27 

X'1B' 

28 

X'1C 

29 

X'1D* 

30 

X'1E' 

31 

X*1F 

32 

X'20* 

33 

X'2V 

34 

X'22' 

37 

X'25* 

38 

X'26' 

39 

X*27' 

40 

X'28' 

41 

X'29* 

42 

X'2A' 

43 

X'2B' 

44 

X'2C 

63 

X'3F 

File  already  open 
LRL  open  fault 
SVC  parameter  error 
Parameter  error 
Extended  error 
Unknown  error  code 
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Appendix  B/Memory  Map 


OPTIONAL        / 

64K  MEMORY  ^       32K 


64K 


BANK1 


BANK  2 


'2400H 

I26Q0HI 

3000H 


SYSTEM  BANK 


BANK0 


TiTTtrrmfi 


Resident  operating  system,  system 
buffers,  overlays,  drivers,  eta 


Library  overlay  zone 


Note:2400Hto2600His 
reserved  for  possible  future 
expansion  of  the  resident 
operating  system  area. 


32K 


64K 


HIGH$ 


All  software  must  observe  HIGH$. 

User  software  which  does  not  allow  TRSDOS  library  commands  to  be  executed 
during  run  time  may  use  memory  from  2600H  to  HIGH$„ 

User  software  which  allows  for  library  commands  during  execution  must  reside 
in  and  use  memory  only  between  3000H  and  H!GH$. 

TRSDOS  provides  all  functions  and  storage  through  supervisor  calls.  No 
address  or  entry  point  below  3000H  is  documented  by  Radio  Shack- 
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Appendix  C/Character  Codes 


Text,  control  functions,  and  graphics  are  represented  in  the  computer  by  codes,, 
The  character  codes  range  from  zero  through  255, 

Codes  one  through  31  normally  represent  certain  control  functions*  For  exam- 
ple, code  13  represents  a  carriage  return  or  "end  of  line."  These  same  codes 
also  represent  special  characters.  To  display  the  special  character  that  corre- 
sponds to  a  particular  code  (1-31 ),  precede  the  code  with  a  code  zero. 

Codes  32  through  127  represent  the  text  characters  —  all  those  letters,  num- 
bers, and  other  characters  that  are  commonly  used  to  represent  textual 
information. 

Codes  128  through  191,  when  output  to  the  video  display,  represent  64  graphics 
characters. 

Codes  192  through  255,  when  output  to  the  video  display,  represent  either 
space  compression  codes  or  special  characters,  as  determined  by  software. 
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ASCII  Character  Set 


Dec.     Hex,     Abbrev.  Keyboard 

0     00     nul        rnmm 


1 

01 

SOH 

(eUD® 

2 

02 

STX 

fCTRDfB) 

3 

03 

ETX 

ctd© 

4 

04 

EOT 

C5TRD(P) 

5 

05 

ENQ 

(hid© 

6 

06 

ACK 

(SUDCE) 

7 

07 

BEL 

{SIHD© 

8 

08 

BS 

© 

(HBD® 

9 

09 

HT 

CD 

(CTRL1CI) 

10 

0A 

LP 

[CTHUtJJ 

11 

0B 

VT 

(CTKDflD 

12 

0C 

FF 

(CTffDfD 

13 

0D 

CR 

(ENTER) 

(CTRLlfH) 

14 

0E 

SO 

CTD® 

15 

0F 

SI 

(gTROfO) 

16 

10 

DLE 

fCTRDfP) 

17 

11 

DC1 

(cTRL)(q) 

18 

12 

DC2 

CgtrD® 

19 

13 

DC3 

(SHD© 

20 

14 

DC4 

fctRPm 

21 

15 

NAK 

(CTRDflJ) 

22 

16 

SYN 

CTD® 

23 

17 

ETB 

CS1D(D 

24 

18 

CAN 

(MED® 

(CTRDfX) 

25 

19 

EM 

US)® 
(OTD© 

26 

1A 

SUB 

(SHIFTS 
(OTD© 

27 

1B 

ESC 

(5HlFT)ffl 
(ETRDm 

28 

1C 

FS 

CTDCD 

Video  Display 

Treat  next  character  as  dis- 
playable;  if  in  the  range  1-31, 
a  special  character  is  dis- 
played (see  list  of  special 
characters  later  in  this 
Appendix). 


29 

1D 

GS 

fCTRDfENTER) 

(OTDO 

30 

1E 

RS 

fcTRpm 

Backspace  and  erase 


Move  cursor  to  start  of  next 
iine 


Move  cursor  to  start  of  next 

line 

Turn  cursor  on 

Turn  cursor  off 

Enable  reverse  video  and 

set  high  bit  routine  on* 

Set  reverse  video  high  bit 

routine  off* 


Swap  space  compression/ 

special  characters 

Swap  special/alternate 

characters 

Set  to  40  characters  per  line 

Backspace  without  erasing 

Advance  cursor 

Move  cursor  down 

Move  cursor  up 

Move  cursor  to  upper  left 
corner  Disable  reverse 
video  and  set  high  bit  rou- 
tine off.*  Set  to  80  charac- 
ters per  line. 
Erase  line  and  start  over 

Erase  to  end  of  line 


*When  the  high  bit  routine  is  on,  characters  128  through  191  are  displayed  as 
standard  ASCII  characters  in  reverse  video. 
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Code            ASCII 

Dec. 

Hex.     Abl 

1F       VS 

arev.            Keyboard 

Video  Display 

31 

(SHIFTKCLEAR) 

Erase  to  end  of  display 

32 

20         SPA             (SPACEBAR) 

(blank) 

33 

21 

CD 

i 

34 

22 

CD 

" 

35 

23 

® 

# 

36 

24 

© 

$ 

37 

25 

© 

% 

38 

26 

© 

& 

39 

27 

CD 

' 

40 

28 

© 

( 

41 

29 

© 

) 

42 

2A 

© 

43 

2B 

© 

+ 

44 

2C 

© 

■ 

45 

2D 

© 

_ 

46 

2E 

Q 

• 

47 

2F 

© 

/ 

48 

30 

® 

0 

49 

31 

CD 

1 

50 

32 

CD 

2 

51 

33 

CD 

3 

52 

34 

® 

4 

53 

35 

CD 

5 

54 

36 

CD 

6 

55 

37 

m 

7 

56 

38 

m 

8 

57 

39 

CD 

9 

58 

3A 

Q 

59 

3B 

© 

60 

3C 

© 

< 

61 

3D 

© 

= 

62 

3E 

© 

> 

63 

3F 

© 

? 

64 

40 

CD 

@ 

65 

41 

CshifDCa) 

A 

66 

42 

(sHiFDfff) 

B 

67 

43 

(SHIFDfCl 

C 

68 

44 

fSHIFfjfD) 

D 

69 

45 

fSHlFDfE) 

E 

70 

46 

CSHlFDfF) 

F 

71 

47 

(SHED© 

G 

72 

48 

tSHIFDO?) 

H 

73 

49 

(sniFnci) 

I 

74 

4A 

(SHED® 

J 

75 

4B 

(SHIFDCK) 

K 

76 

4C 

(SHIPPCD 

L 

77 

4D 

(SHlFDtff) 

M 

78 

4E 

(SHIFPCN) 

N 

79 

4F 

(sBifDCO) 

0 

80 

50 

fSHIFPfF) 

P 

81 

51 

fsmmfffi 

Q 

82 

52 

(SHimCRl 

R 

83 

53 

CsHlFDfSl 

S 

84 

54 

csHirnm 

T 

85 

55 

C5HlFT)fUl 

U 

86 

56 

CSHIFDCV) 

V 

87 

57 

fSHlFPff) 

w 

88 

58 

csHimnri 

X 

89 

59 

(SHIFPCY) 

Y 
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DEL 


Code  ASCII 

Dec.     Hex.     Abbrev.      Keyboard  Video  Display 

[SHIFTKD  Z 

■Q  f 

(CL£AR)CD  \ 

■Q  ] 

(CLSARJCTl 

(OEAH)fENTER)  ~~ 

mwt)m 

®  a 

©  b 

©  c 

©  d 

CD  e 

©  f 

©  g 

m  h 

CD  i 

CD  j 

CD  k 

CD  i 

(MJ  m 

®  n 

©  o 

©  P 

©  q 

©  r 

©  s 

(D  t 

©  u 

®  v 

CD  w 

®  x 

©  y 

S3  z 
{ 
I 
} 


90 

5A 

91 

5B 

92 

5C 

93 

5D 

94 

5E 

95 

5F 

S6 

60 

97 

61 

98 

62 

99 

63 

100 

64 

101 

65 

102 

66 

103 

67 

104 

68 

105 

69 

106 

6A 

107 

6B 

108 

6C 

109 

6D 

110 

6E 

111 

6F 

112 

70 

113 

71 

114 

72 

115 

73 

116 

74 

117 

75 

118 

76 

119 

77 

120 

78 

121 

79 

122 

7A 

123 

7B 

124 

7C 

125 

7D 

126 

7E 

127 

7F 
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Extended  (non-ASCII)  Character  Set 


Code 
Dec,     Hex. 

128  80 

129  81 


130 


82 


Keyboard 

CUM 

(ED 

(DDCTD® 


Video  Display 


131 


83 


132 

84 

133 

85 

134 

86 

135 

87 

136 

88 

137 

89 

138 

8A 

139 

8B 

140 

8C 

141 

8D 

142 

8E 

143 

8F 

144 

90 

145 

91 

146  92 

147  93 


148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 


94 
95 
96 
97 
98 
99 
9A 
9B 
9C 
9D 
9E 
9F 
A0 
A1 
A2 
A3 
A4 
A5 
A6 
A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 
B0 
B1 
B2 


(HfflpfflD© 
(CIEAR)CCTRD(D) 
fCLEAfilfCTRDfE) 
(EHAR)(CTRLlfn 

dEMDOTD© 

(CLEARKETRDfHI 
(CLEARl(C7RLim 

CSEM(cTrD(D 

(CLEARKCTRDftl 
(ELEAR)(CTHT)fD 
(CrEAR)(CTRL)(H) 

(MDCTD® 

(ELgAR)(CTHL)fg) 
[ClEARjfCTRDfP) 

(SHIFDtFI) 

mirnm 

fCLEARjfCTRDtm 
(5HIFTXFS) 

(EEM(CTRncgj 

craD(mDCD 

(ECEARlfCTRDfin 
(DS)(cTrD® 

(SETOCcmD® 

ccrrotniBD© 
(crEaBifrmpd) 

fCtEAR](SHIFT)ffl 


cecrodHiFDd) 

(CLEAR)($HlFn(g) 
(CLEAR)fSHIFnCT) 
(CLEAfi)fSHimfD 
(ClM)(SHIFT)(|) 

fcLEARKsHirnm 

(CLEARlfSHimfg) 

(5LEAR)f5Himfg) 


DDE) 


(gCEAmm 

(DE)(D 
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Code 

Dec. 

Hex. 

179 

B3 

180 

B4 

181 

B5 

182 

B6 

183 

B7 

184 

B8 

185 

B9 

186 

BA 

187 

BB 

188 

BC 

189 

BD 

190 

BE 

191 

BF 

192 

CO 

193 

C1 

194 

C2 

195 

C3 

196 

C4 

197 

C5 

-fOO 

r»c 

199 

C7 

200 

C8 

201 

C9 

202 

CA 

203 

CB 

204 

CC 

205 

CD 

206 

CE 

207 

CF 

208 

DO 

209 

D1 

210 

D2 

211 

D3 

212 

D4 

213 

D5 

214 

D6 

215 

D7 

216 

D8 

217 

D9 

218 

DA 

219 

DB 

220 

DC 

221 

DD 

222 

DE 

223 

DF 

224 

E0 

225 

E1 

226 

E2 

227 

E3 

228 

E4 

229 

E5 

230 

E6 

231 

E7 

232 

E8 

233 

E9 

234 

EA 

Keyboard 

(CCHRM5) 

511?® 

fctHRKD 

fClEftRKD 

(cieaTO 

CCLEARKD 
(CLEARlfT) 


Video  Display 


(elEARKlT 
(ClEAR)Qr 
(CTearXKT 
(IffifDGD*' 

(EEEBRKHT 

(CLEAR]©*1 
[ClEAR)®1" 

(CTEARlfPT 
(cTEAR)(gr 
(CtEffR)®*' 
(ClEABXsT 
(ceea*rxtt 
(clear)®*' 

(clearjcvt 

(CLEARJdT 

(CLEAR)©*' 
(CLEARlY)*' 
(CLEARW 


(CLEARj[SHIFT)(@) 
(ClEAR)(SHIFT)(A) 
(CTJATflCSHlFT)® 
(CTEARl(SHlF7)(g) 
(CTEARKSHlFntD) 
fCTEAR)(SHlFT](EJ 
[CTEAB)fSHIFflfF) 

(cTEaR)[shifT)(g) 

(CLEAR)(5HlFr)(H) 
(ClEAn)CSHlFT)(I) 
(CTEAR](SHIFTJtJ) 


»4 

f  & 
2  a 

O)  < 

a>  « 

co  £ 


'Empties  the  type-ahead  buffer 

*Used  by  Keystroke  Multiply,  if  KSM  is  active, 
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Code 

Dec. 

Hex. 

Keyboard 

Video  Display 

235 

EB 

(CLEAH)(SHlFnrK) 

236 

EC 

(MSdflSDCD 

.__ 

237 

ED 

CCLEARlfSHlFDfHl 

c 

CD 

238 

EE 

(raDdHHD® 

239 

EF 

(EEOTfSBimffil 

< 

240 

F0 

(MffiXiBIED© 

£Z 

241 

F1 

CcEUDdHiFl)® 

C 

242 

F2 

(CHAR}(SHIFT]fHl 

to 

243 

F3 

(CLEMlfSHlFDff) 

s 

244 

F4 

(CLEfiffifSHlFTlfT) 

ca 

245 

F5 

CElEARlfSHlFTiaj] 

246 

F6 

(ClEARKSHlFDfVJ 

o 

247 

F7 

(CLEAR)CSHXTnfW) 

"co 
o 

248 

F8 

(ClEARlfSHimffi 

CD 

ex 

249 

F9 

ccLEAHifsHirnm 

CO 

250 

FA 

(ffiJAH)(SHIFT)fZ) 

*s 

253 

FD 

CO 

254 

FE 

Q) 

255 

FF 

CD 
CO 
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Graphics  Characters  (Codes  128-191) 


3 

I 

s 

g 

I 

~Xi 

Jil 

^_ 

-v. 

-a 

■3= 

.....". 

:-( 

-57 

11 

E 

1 

"TT 

22 

J 

J 

■wf 

j^ 

* 

-& 

T_ 

E 

— 

Ig 

~ 

c 

I 

1 

= 

= 
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Special  Characters  (0-31,  192-255) 


I  eu S-io 

0  1  2  3  4  5  6  7 


8       9       10  11  12  13      14  15 

16       V                18  19  20  21      22  23 

24      25      26  27  28  29      30  31 

192      193      194  195  196  197      198  199 

otp  Y  S  "€  ?  ^1  ^ 
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Appendix  D/Keyboard  Code  Map 


The  keyboard  code  map  shows  the  code  that  TRSDOS  returns  for  each  key,  in 
each  of  the  modes:  control,  shift,  unshift,  clear  and  control,  clear  and  shift,  clear 
and  unshift 

For  example,  pressing  (cO-ar),  (SHIFT),  and  CD  at  the  same  time  returns  the  code 
XAT 

A  program  executing  under  TRSDOS  —  for  example,  BASIC  -—  may  translate 
some  of  these  codes  into  other  values.  Consult  the  program's  documentation 
for  details., 

(break)  Key  Handling 

The  (BREAK)  key  (XW)  is  handled  in  different  ways,  depending  on  the  settings 
of  three  system  functions,  The  table  below  shows  what  happens  for  each  com- 
bination of  settings. 

Break        Break        TWe~ 
DreaK       Vector      Ahead 

Set        Enabled 


Enabled 


N  Y  If  characters  are  in  the  type-ahead  buffer, 

then  the  buffer  is  emptied* 


If  the  type-ahead  buffer  is  empty,  then  a 
BREAK  character  (X'80')  is  placed  in  the 
buffer* 


A  BREAK  character  (X'80')  is  placed  in  the 
buffer. 


The  type-ahead  buffer  is  emptied  of  its  con- 
tents (if  any),  and  control  is  transferred  to  the 
address  in  the  BREAK  vector  (see  ©BREAK 
SVC).* 


Control  is  transferred  to  the  address  in  the 
BREAK  vector  (see  ©BREAK  SVC). 


No  action  is  taken  and  characters  in  the  type- 
ahead  buffer  are  not  affected. 


'Because  the  (break]  key  is  checked  for  more  frequently  than  other  keys  on  the 
keyboard,  it  is  possible  for  dHME)  to  be  pressed  after  another  key  on  the  key- 
board and  yet  be  detected  first. 

Y  means  that  the  function  is  on  or  enabled 
N  means  that  the  function  is  off  or  disabled 
X  means  that  the  state  of  the  function  has  no  effect 

Break  is  enabled  with  the  SYSTEM  (BREAK  =  ON)  command  (this  is  the 

default  condition). 
The  break  vector  is  set  using  the  @BREAK  SVC  (normally  off). 
Type-ahead  is  enabled  using  the  SYSTEM  (TYPE -ON)  command  (this  is  the 

default  condition), 
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Appendix  E/Programmable  SVCs 

(Under  Version  6.2  only) 

SVC  numbers  124  through  127  are  reserved  for  programmer  installable  SVCs, 
To  install  an  SVC  the  programmer  must  write  the  routine  to  execute  when  the 
SVC  is  called. 

The  routine  should  be  written  as  high  memory  module  if  it  is  to  be  available  at 
all  times.  If  you  execute  a  SYSGEN  command  when  a  programmable  SVC  is 
defined,  the  address  of  the  routine  is  saved  in  the  SYSGEN  file  and  restored 
each  time  the  system  is  configured.  If  the  routine  is  a  high  memory  module,  the 
routine  is  saved  and  restored  as  well  This  makes  the  SVC  always  available, 
For  more  information  on  high  memory  modules,  see  Memory  Header  and  Sam- 
ple Program  F. 

To  install  an  SVC,  the  program  must  access  the  SVC  table  The  SVC  table  con- 
tains 1 28  two-byte  positions,  a  two-byte  position  for  each  usable  SVC,  Each  po- 
sition in  the  table  contains  the  address  of  the  routine  to  execute  when  the  SVC 
is  called. 

To  access  the  SVC  table,  execute  the  (&FLAGS  SVC  (SVC  101).,  IY  +  26  con- 
tains the  MSB  of  the  SVC  table  start  address.  The  LSB  of  the  SVC  table  ad- 
dress is  always  0  because  the  SVC  table  always  begins  on  a  page  boundary 

Store  the  address  of  the  routine  to  be  executed  at  the  SVC  number  times  2  byte 
in  the  table.  For  example,  if  you  are  installing  SVC  126,  store  the  address  of  the 
routine  at  byte  252  in  the  table,  Addresses  are  stored  in  LSB-MSB  format 

When  the  SVC  is  executed,  control  is  transferred  to  the  address  in  the  table.  On 
entry  to  your  SVC,  Register  A  contains  the  same  value  as  Register  C  All  other 
registers  retain  the  values  they  had  when  the  RST  28  SVC  instruction  was 
executed. 

To  exit  the  SVC,  execute  a  RET  instruction.  The  program  should  save  and  re- 
store any  registers  used  by  the  SVC 

Initially,  SVCs  124  through  127  display  an  error  message  when  they  are  exe- 
cuted., When  installing  an  SVC  you  should  save  the  original  address  at  that  lo- 
cation in  the  table  and  restore  it  when  you  remove  the  SVC, 

These  program  lines  insert  a  new  SVC  into  the  system  SVC  table,  save  the  pre- 
vious value  of  the  table,  and  reinsert  that  value  before  execution  ends.  You 
could  check  the  existing  value  to  see  if  the  address  is  above  X'2600\  If  it  is,  the 
SVC  is  already  assigned  and  should  not  be  used  at  this  time. 

This  code  inserts  SVC  126,  called  MYSVC: 


LD 

A,(aFLAGS 

;Locate  start  of  SVC  table 

RST 

28H 

Execute  (ci  FLAGS  SVC 

LD 

H,(IY  +  26) 

;Get  MSB  of  address 

LD 

L,  126*2 

;WanttouseSVC126 

LD 

(OSVC126A),HL 

;Save  address  of  SVC  entry 

LD 

E,(HL) 

;Get  current  SVC  address 

INC 

HL 

LD 

D,(HL) 

LD 

(OSVC126V),DE 

;Save  the  old  value 

DEC 

HL 

LD 

DE,MYSVC 

;Get  address  of  routine  for 
;SVC126 

LD 

(HL),E 

;lnsert  new  SVC  address  into 
;table 

INC  HL 
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LD  {HL),D 

'.  Code  that  uses  MYSVC  (SVC  126) 


This  code  removes  SVC  126: 


LD 

HLf(OSVC126A) 

;Get  address  of  SVC  entry 

LD 

DE,(OSVC126V) 

;Get  original  value 

LD 

(HL),E 

; Insert  original  SVC  address 

INC 

HL 

LD 

(HL),D 
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Appendix  F/Usiog  SYS13/SYS 

(Under  Version  6.2  only) 


With  TRSDOS  Version  6,2,  you  can  create  an  Extended  Command  Inter- 
preter (ECI)  or  an  Immediate  Execution  Program  (IEP),  TRSDOS  can  store 
either  an  ECI  or  IEP  in  the  SYS13  file.,  Both  programs  cannot  be  present  at 
the  same  time 

At  the  TRSDOS  Ready  prompt  when  you  type  QD  CENTER).  TRSDOS  exe- 
cutes the  program  stored  in  SYS13/SYS  Because  TRSDOS  recognizes  the 
program  as  a  system  file,  TRSDOS  includes  the  file  when  creating  backups 
and  loads  the  program  faster 

If  you  want  to  write  additional  commands  for  TRSDOS,  you  can  write  an  in- 
terpreter to  execute  these  commands.  Your  ECI  can  also  execute  TRSDOS 
commands  by  using  the  @CMND!  SVC  to  pass  a  command  to  the 
TRSDOS  interpreter 

If  EFLAG$  contains  a  non-zero  value,  TRSDOS  executes  the  program  in 
SYS13/SYS.  If  EFLAG$  contains  a  zero,  TRSDOS  uses  its  own  command 
interpreter. 

Sample  Program  G  is  an  example  of  an  ECI I ,  It  is  important  to  note  that  your  ECI 
must  be  executable  by  pressing  GD  (ENTER)  at  the  TRSDOS  Ready  prompt 

An  ECI  can  use  alt  of  memory  or  you  can  restrict  it  to  use  the  system  overlay 
area(X'2600'toX'2FFF). 

To  implement  an  IEP  or  ECI,  use  the  following  syntax: 

COPY  fifespec  SYS13/SYS  LSIDOS:dr/Ve  (C-N)  CENTER) 

filespec  can  be  any  executable  (/CMD)  program  file ,  drive  specifies  the  desti- 
nation drive.  The  destination  drive  must  contain  an  original  SYS13/SYS  file. 

Example 

COPY  SCRIPSIT/CMD:1  SYS13/SYS,LDI:0  (C  =  N) 

TRSDOS  copies  SCRIPSIT/CMD  from  Drive  1  to  SYS13/SYS  in  Drive  0,  At  the 
TRSDOS  Ready  prompt,  when  you  press  CD  CENTER).  TRSDOS  executes 

scripsit, 
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Index 


Subject 


Page    Subject 


Page 


@ABORT    48 

Access 

device    9-10 

drive 11-21 

file    4 

@ADTSK  49 

Alien  disk  controller 12 

Allocation 

dynamic    . , 3 

information 1 2,  25 

methods  of  3 

pre-    3 

unit  of    2 

ASCII  codes    202-04 

Background  tasks,  invoking  33-34 

@BANK   37-39 

Bank  switching   36-39 

@BKSP    52 

BOOT/SYS    5 

BREAK 

detection   29-32,  53 

key  handling 211 

©BREAK 53 

Byte  I/O   40-42 

Characters 

ASCII  202-04 

codes  201-10 

graphics    205-06,  208 

special  206-07,  209-10 

@CHN!0 54 

@CKDRV 55 

@CKBRKC 55 

@CKEOF    56 

@CKTSK  57 

Clock  rate,  changing  192 

@CLOSE  60 

@CLS    61 

@CMNDI   63 

@CMNDR 64 

Codes 

ASCI! 202-04 

character 201-10 

error  197 

graphics    205-06,  208 

keyboard  211-12 

return  28 

special  character 206-07,  209-10 

Converting  to  TRSDOS  Version  6    . . , .  27-28 

CREATEd  files    15 

@CTL 40-42,  65-66 


interfacing  to  device  drivers    42-44 

Cylinder 

highest  numbered   12 

number  of  , 18 

position,  current  12 

starting 25 

@DATE    . ,. 67 

@DCINIT  68 

@DCRES    69 

@DCSTAT ,  70 

DEBUG    6 

(SDEBUG 71 

@DECHEX 72 

Density,  double  and  single 1 ,  11,  18 

Device 

access  9-10 

handling    27 

NIL   9 

Device  Control  Block  <DCB)    9 

Device  driver 7,  8,  1 3 

address 9 

COM    43-44 

@CTL  interfacing  to   42-44 

keyboard  . . , 43 

printer    ,  43 

templates    40-42 

video 43 

Devspec  9 

Directory 

location  on  disk 2,  12 

primary  and  extended  entries  14 

16,  20 

record,  locating  a    20 

records  (DIREC)    13-16 

sectors,  number  of   14 

Directory  Entry  Code  (DEC)    18-19 

20,  24 

@DIRRD 73 

DIR/SYS 5 

@DIRWR   , 74 

Disk,  diskette 

controller  12 

double-sided    11-12,  17,  18 

files    ,. .  13-14 

floppy  1 

formatting    17,  18 

hard 2 

I/O  table    13 

minimum  configuration  7-8 

name   18 
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Subject 


Page     Subject 


Page 


organization 1-2 

single-sided    11-12,  17,  18 

space,  available    2 

@DIV8   75 

@DIV16  76 

@DODIR    77-78 

Drive 

access  1 1  -22 

address 12 

floppy 1,11 

hard 2,  11 

size    ..11 

Drive  Code  Table  DOT   1  i-13 

Driver  —  see  Device  driver 

@DSP    , ,  79 

@DSPLY 80 

End  of  File  (EOF)    15 

Ending  Record  Number  (ERN)   16,  25 

ENTER  detection  29-32 

Error 

codes  and  messages 193-197 

dictionary    6 

@ERROR    81 

@EXIT   82 

Extended  Command  Interpreter    84,  215 

@FEXT 83 

File 

access  4 

descriptions,  TRSDOS  5-8 

modification    15 

Fife  Control  Block  <FCB)    23 

Files 

CREATEd   15 

device  driver    7 

filter    7 

system  (/SYS)    5-6,  7-8,  19 

utility    7 

Filter  templates 40-42 

Filters  7,  8,  40-42 

example  of   42 

FLAGS   28,  84-86 

@FNAME    87 

@FSPEC   89 

@GET    40-42,  90 

Gran,  granule 

allocation  information  25 

definition   2,17 

per  track   1-2,  12 

Granule  Allocation  Table  (GAT) 

location  on  disk  2 


contents  of   16-18 

Graphics 

characters,  printing 190 

codes 205-06,  208 

@GTDCB 91 

@GTDCT 92 

@GTMOD 93 

Guidelines,  programming   27-44 

Hash  code 15,  18 

Hash  Index  Table  (HIT) 

location  on  disk 2 

explanation  of    , ,    18-19 

(ojHDFMT    94 

©HEXDEC 95 

@HEX8    96 

@HEX16    97 

@HIGH$    98 

@ICNFG,  interfacing  to    32-33 

Immediate  Execution  Program    215 

@INIT 99 

Initialization  configuration 

vector    32-33 

Interrupt  tasks  34-36 

@IPL    100 

Job  Control  Language  (JCL)  6,  28 

@KBD    101 

@KEY    102 

Keyboard  codes  211-12 

@KEYIN    103 

KFLAG$  29 

@K(TSK,  interfacing  to  33-34 

@KLTSK    104 

Library  commands  28 

technical  information  on  . . 189-91 

@LOAD    105 

@LOC    ..,. 106 

@LOF    107 

LOG  utility  190 

@LOGER    108 

Logical  Record  Length  (LRL)    15,  24 

@LOGOT    , 109 

Memory  banks  —  see  RAM  banks 

Memory  header    1 0,  27 

Memory  map 199 

Minimum  configuration  disk  7 

Modification  date    15 

@MSG  110 

@MUL8    111 

@MUL16   112 

Next  Record  Number  (NRN) 24 
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Subject  Page 

NIL  device  9 

©OPEN  113 

Overlays,  system   — 5-6,  19 

@PARAM    114-15 

Password 

for  TRSDOS  files    8 

protection  levels    14,  24 

©PAUSE    116 

PAUSE  detection    29-32 

©PEOF 117 

©POSN  118 

@P^INT 119 

Printing  Graphics  Characters    190 

Programming  Guidelines    27-44 

Protection  Levels 14,  24,  27 

@PRT 120 

@PUT    40-42,  121 

RAM  Banks 

switching  36-39 

use  of    50-51 

@RAMDIR     122 

@RDHDR 123 

@RDSEC    124 

@RDSSC 125 

@RDTRK  ,,, 126 

©READ   127 

Record 

length    3-4,  15,  24 

logical  and  physical    3-4 

numbers 4 

processing    4 

spanning   ,3-4 

©REMOV    128 

©RENAM    129 

Restart  Vectors  (RSTs)  29 

Return  Code  (RC)   28 

©REW 130 

©RMTSK    131 

©RPTSK 132 

©RREAD    133 

RS-232 

initializing 32 

COM  driver  for 43-44 

©RSLCT  134 

©RSTOR  135 

©RUN 136 

©RWRIT  137 

Sample  Programs    1 60-83 

A 161 

B  163 


Subject 
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C     .- 168 

D 175 

E  177 

F , 178 

G 187 

Sectors 

per  cylinder    14,  19 

per  granule , .  1-2,  12 

©SEEK    138 

©SEEKSC    139 

©SKIP   140 

©SLCT 141 

©SOUND    142 

Special  Character  Codes  ....  206-07,  209-10 

Stack  handling   28 

Step  rate 11 

changing   189 

©STEPI 143 

Supervisor  calls  (SVCs) 

calling  procedure  45 

lists  of    46-47,  155-57,  158-59 

program  entry  and 

return  conditions  45 

sample  programs  using   160-183 

using 45-183 

SYS  files    5-6,  7-8,  19 

System 

files    5-6,  7-8,  19 

overlays    5-6,  19 

Task 

interrupt  level,  adding 49 

slots  34,  35,  49 

Task  Control  Block  (TCB)  34,  35,  49 

Vector  Table  (TCBVT)    34,  35 

Task  processor,  interfacing  to   34-36 

©TIME  , ..  144 

TRSDOS 

converting  to  Version  6    27-28 

error  messages  and  codes  193-97 

file  descriptions „  5-8 

technical  information  on 

commands  and  utilities    189-91 

TYPE  code 23 

©VDCTL 145-46 

©VER    147 

Version,  operating  system    17 

Visibility    14 

©VRSEC     148 

WAIT  value,  changing  1 90 

©WEOF 149 
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©WHERE    150 

@WRITE    151 

Write  Protect  9 


@WRSEC    152 

@WRSSC    153 

@WRTRK 154 
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